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RUN-TIME SYSTEM 



Installation 

Part numbers: 690-2 1170-nnn 
690-21869-nnn 

• Installation and upgrade 

• Set up Multidrop and UPS 

Using the AOM'" Menu System 

Part number: 690-18055-nnn 

• Easy-to-use menus to 
access programs 

• Menu Manager to add, update, 
remove menus 

Operations Guide 

Part number: 690-21 171-nnn 

• System administration 

• Accounting, file systems 

• Backups, port setup 

• Communications (UUCP) 

• Error messages 

Reference (C) 

Part number: 690-22869-nnn 

• Commands (C) 

Reference (M) 

Part number: 690-22870-nnn 

• Miscellaneous files (M) 
User's Guide 

Part number: 690-211 78-nnn 

(Not shipped with the Run-time system) 

• Basic concepts and tasks 

• Vi, ed, mail, awk, sed 

• Shells: sh and csh 



TE)CT PROCESSING SYSTEM 



DEVELOPMENT SYSTEM 

Set part number: 690-21585-000 
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Reference (CP, S, F) 

• Programming commands (CP) 

• System calls, library routines (S) 

• File formats (F) 

Programmer's Guide 

• Make, sees 

• Lex, yacc 

• Signals, system resources, 
device drivers 

• Adb, sdb 

• Shared libraries 

C Compiler Library and User's Guide 

• I/O functions, pipes 

• Curses, terminfo 

• Assembly routines 

. As, cc, COFF, lint, Id 

• Error processing 

• Character and string processing 

C Compiler Language Reference 

• Elements of C 

• Program structure 

• Declarations, expressions 

• Statements, functions 

• Preprocessor directives 

Macro Assembler User's Guide 
and Reference 

• How to use masm 

• Error messages 

• Type declarations 

• Operands, expressions 

• Directives, file control 

• Instruction summary 



DOCUMENTER'S WORKBENCH' 

Part numbers: 690-15843-nnn 
690-15844-nnn 

• Mm macros, reference 

• Nroff, troff, tbl, eqn 



To order the User's Guide or any of the above manuals, call 408/434-6688, ext. 3004 
and give the manual title and part number. 



About This Manual 



USING THIS MANUAL 



This reference alphabetically describes the commands and 
programs that are on the Altos System V^" Run- time System. 
Altos System V is based on UNIX® System V Release 3 with 
enhancements from Altos and Microsoft. 



ORGANIZATION 



This manual contains the commands, programs, and utilities 
(C) of the Run- time system. 

For miscellaneous utilities and files (M), see the Refer- 
ence (M). 



NOTE 

The last section of the manual, "Change 
Information," summarizes the changes that have 
been made to the manual since the previous 
version. 



MANUAL CONVENTIONS 



The documentation conventions used in this manual are ex- 
plained on the following page. 
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Symbol 



Description 



boldface type What you type. For example: 

Type tartv 

boldface type Used for command or parameter names 

that must be typed as shown. 

mall user 

italic type Variables (a value that can change), 

such as user. See the previous exam- 
ple. Also for manual titles, such as 
Reference (C) and Reference (M). 

■•iiiM Keys you press simultaneously (sepa- 

ated by a hyphen and shown in re- 
verse type). For example: 



[ ] 



Ctrl-d 



means you press and 
hold the QQI ^^^^ 
press the d key. 

Keys you press sequentially. 

Optional items in a syntax statement. 
If you do not use the optional item, 
the program selects a default action 
to carry out. 

Use only one of the separated items. 

Repeat preceding argument one or 
more times. 

Repeat the preceding argument one or 
more times and separate arguments 
with a comma. 

Terms defined in the text. Quotation 
marks also indicate text from a 
source code example. 
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ADDITIONAL REFERENCE MATERIALS 



For more information on your operating system, see the 
following list of manuals. To order a manual, call (408) 
434-6688, ext. 3004 and give the manual title and part 
number. 

Owner's Guide (part number 690-21264-nnn or 690-20351- 
nnn) describes how to connect computer components and 
peripherals, turn on power, and use the diagnostic 
programs. 

Using the AOM Menu System (part number 690-18055-nnn) 
describes how to use the Altos Office Manager (AOM) to 
install software and manage the operating system. 

Altos System V User's Guide (part number 690-21 178-nnn) 
(not shipped with the Run-time system) explains basic 
operating system concepts and programs (e.g., vi, ed, sh, 
csh, mail, sed, and awk). 

Altos System V Series 386 Operations Guide (part number 
690-2117 1-nnn) tells how to set up the system for users 
and peripherals, maintain and back up the system, optimize 
system performance, and use uucp communications programs. 
This manual also contains system and LP spooler error mes- 
sages. 

Altos System V Series 386 Reference (M) (part number 
690-22870-nnn) describes the Altos Run-time system utili- 
ties and files. 

Altos System V Series 386 Development System Set (part 
number 690-21585-000) contains reference and tutorial 
material. 

Manuals in this set include: 

Altos System V Series 386 C Compiler Library and 

User's Guide 

Altos System V Series 386 C Compiler Language 

Reference 

Altos System V Series 386 Programmer's Guide 

Altos System V Series 386 Macro Assembler User's 

Guide and Reference 

Altos System V Series 386 Reference (CP, S, F) 
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DOCUMENTER'S WORKBENCH (part numbers 690-15843-nnn 
and 690-1 5844-nnn) describes mm, nroff, troff, and type- 
setting functions and commands. 
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Permuted index 



The Permuted Index on the following pages contains 9 listing of 
programs, utilities, files, etc. in the Altos System V Run-time 
and Development Systems. These programs are described in the 
Alton System V Reference. Volume 1 of the Reference contains the 
Run-time system commands (C) and miscellaneous (M) sections. 
Volume 2 contains the Development system programming commands 
(CP), system calls and library routines (S), and file formats (F). 
) I:n tries in each section are in alphabetical order. 



NOTE 

These programs, utilities, files, etc. are 
subject to change. 



The table that follows contains a description of each section and 
its location. 



PI-1 



Permuted Index 



Description 



Run-time commands 

Miscellaneous ~ programs 
and system files used for 
system maintenance and to 
access devices 

Programming commands 

System calls and library 
routines for C and assembly 
language programming 

File formats ~ programs 
and system files not de- 
fined in the M section 



Section Manual 

C Reference (C) 

M Reference (M) 

CP Reference (CP, S, F 

S Reference (CP, S, F 

F Reference (CP, S, F 



PI-2 



Permuted Index 



as(CP) 

13toi(S) ltol3(S) convert between 
tk(C) paginator for Tektronix 
integer and base-64 ASCII string 

abs(S) return integer 
ceil(S) fabs(S) floor, ceiling, and 
tloor(S) fmod(S) floor, ceiling, and 

requests 
settime(C) change the 
touch(C) update 
utime(S) set file 
login (C) give you system 
sputKS) sgetKS) 
dos(C) 
sadp(M) disk 
Idfcn(F) common object file 
sdwaitv(S) synchronize shared data 
sdenter(S) sdleave(S) synchronize 
waitsem(S) nbwaitsem(S) wait and check 
clock (M) provide 
getutent(S) utmpname(S) endutent(S) 
getut(S) setutent(S) getutline(S) 
access(S) determine 
file 

csplit(C) split files 
acct(S) enable or disable process 
acct(M) format of per-process 
acct (C) 

file 
accounting 

trig(S) sin(S) cos(S) tan(S) asinCS) 
killall(C) kill all 
sar{C) system 
sar(M) system 
sact(CP) print current SCCS file edit 
debugger 
add.hd(C) 
nl(C) 

map badblock(C) 
Ipinit(M) 
putenv(S) change or 

add.hd(C) add an 
upgrade . hd(C) upgrade an 
files 

admin (CP) create and 
ua(C) user 
uadmin(S) 
machines 

mail alias file 
alarm(S) set a process 

brk(S) sbrk(S) change data segment space 



386 Assembler 

3-byte integers and long integers 

4014 

a641(S) 164a(S) convert between long 

abort (S) generate an lOT fault 

absolute value 



absolute value functions floor(S) 
absolute value functions 



as(CP) 
13tol(S) 
tk(C) 
a641(S) 
abort (S) 
abs(S) 
floor (S) 
floor (S) 
abs(S) 
accept (C) 
settime(C) 
touch(C) 
utime(S) 
login (C) 
sputKS) 
dos(C) 
sadp(M) 
Idfcn(F) 
sdgetv(S) 
sdenter(S) 
waitsem(S) 
clock (M) 
getut(S) 
getut(S) 
access (S) 

access(S) determine accessibility of a access(S) 



abs(S) return integer absolute value 

accept (C) reject (C) allow/prevent print 
access and modification dates of files _ 
access and modification times of a file 

access and modification times 

access 

access long integer data 

access MS-DOS files 

access profiler 

access routines 

access sdgetv(S) 



access to a shared data segment 

access to semaphore resource 

access to the time-of-day chip 
access utmp file entry getut(S) 

access utmp file entry 

accessibility of a file 



according to context 

accounting 

accounting file 



accounting system 

acct(C) accounting system 

acct(M) format of per-process accounting 

acct(S) enable or disable process 

acos(S) trigonometric functions 

active processes 

activity report package 

activity report package 

activity 

adb(C) invoke x.out general purpose 

add an additional hard disk 

add line numbers to a file 

add new bad sectors to the bad sector 

add new line printers 



add value to environment 

add.hd(C) add an additional hard disk 

additional hard disk 

additional hard disk 



admin (CP) create and administer SCCS 

administer SCCS files 

administration program 

administrative control 



aftp(C) transfer files between Altos 

aliases (M) mail alias file 

aliashash(M) rebuild data base for 

alarm clock 



alanii(S) set a process alarm clock 
allocation 



csplit (C) 

acct(S) 

acct(M) 

acct(C) 

acct(C) 

acct(M) 

acct(S) 

trigCS) 

killall(C) 

sar (C) 

sar(M) 

sact(CP) 

adb(C) 

add.hd(C) 

nl(C) 

badblock(C) 
Ipinit(M) 
putenv(S) 
add.hd(C) 
add.hd(C) 
upgrade. hd(C) 
admin (CP) 
admin (CP) 
. ua(C) 
uadmin(S) 
aftp(C) 
aliases (M) 
aliashash(M) 
alarm(S) 
alarm(S) 
brk(S) 
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Permuted Index 



free(S) realloc(S) fast main memory 
malloc(S} main memory 
mallopt(S) calloc(S) fast main memory 
terminal mesg(C) 
get and set maximum number of users 
accept (C) reject (C) 
aftp(C) transfer tiles between 
lex(CP) generate programs for lexical 
editor output 
dc(C) 
bc(C) 

cpio(F) format of cpio 
ar(F) 
xar(F) 

the archive header of a member of an 
tar(C) 

file Idahread(S) read the 
streaming tape 
ar(CF) maintain 
xar(CP) maintain 
cpio(C) copy file 
ranlib(CP) convert 



varargs(F) handles variable 
getopt(S) get option letter from 
expr(C) evaluate 
echo(C) echo 
bc(C) arbitrary-precision 
asa(C) interpret 
characters 
ascii(M) map of the 
convert between long integer and base-64 



time to string ctime(S) tzset(S) 
trig(S) sln(S) cos(S) tan(S) 

a.out(F) format of 
as (CP) 386 
masm(CP) invoke the macro 
assert (S) verify program 

setbuf(S) setvbuf(S) 
trig(S) atan(S) 
trig(S) 
later time 

double-precision number atrtod(S) 
strtol(S) atol(S) 
integer strtol(S) 
sdget(S) 8dfree(S) 
reboot (C) 
reboot the system 
language 

wait(C) wait completion of 
finc(M) fast Incremental 
ckbupacd(M) check file system 



allocator malloc(S) 

allocator 

allocator malloc(S> mallinfo(S) 

allow or disallow messages sent to a 

allowed to log in numusers(S) 

allow/prevent print requests 

Altos machines 

analysis 



a.out(F) format of assembler and link 

arbitrary precision calculator 

arbitrary-precis 
archive 



arithmetic language 



archive file format 

archive file format 

archive file Idahread(S) read 
archive files 



archive header of a member of an archive 

archive(C) save a file system to a 

archives and libraries 

archives and libraries 

archives in and out 



archives to random libraries 

ar(CP) maintain archives and libraries 

ar(F) archive file format 

argument list 



argument vector 

argtiments as an expression 
arguments 



malloc(S> 
malloc(S) 
malloc(S) 
mesg(C) 
numusers ( S ) 
accept (C) 
aftp(C) 
lex (CP) 
a.out(F) 
dc(C) 
bc(C) 
cpio(F) 
ar(F) 
xar(F) 
Idahread(S) 
tar(C) 
Idahread(S) 
archive (C) 
ar(CP) 
xar(CP) 
cpio(C) 
ranlib(CP) 
ar(CP) 
. ar{F) 
varargs(F) 
getopt(S) 
expr(C) 
echo(C) 
bc(C) 
asa(C) 



ASCII string a641(S) 164a(S) 



arithmetic language 

asa carriage control characters 

asa(C) interpret asa carriage control asa(C) 

ASCII character set ascii(M) 

a641(S) 

ascii(M) map of the ASCII character set _ ascii(M) 

as (CP) 386 Assembler as (CP) 

asctime(S) cftime(S) convert date and ctime(S) 

asin(S) acos(S) trigonometric functions _ trig(S) 

asktime(C) set the system time of day a8ktime(C) 

assembler and link editor output 

Assembler 

assembler 

assertion 



assert(S) verify program assertion 

assign buffering to a stream 

atan2(S) trigonometric functions 



atan(S) atan2(S) trigonometric functions 

at(C) batch(C) execute commands at a 

atof(S) convert string to 



atoi(S) convert string to integer 

atol(S) atoi(S) convert string to 

attach and detach a shared data segment 

automatically reboot the system 

autoreboot (C) automatically 



awk(C) pattern scanning and processing 

background processes 

backup 

backup schedule 



a.out(F) 
as (CP) 
masm(CP) 
assert (S) 
assert (S) 
setbuf (S) 
trig(S) 
trig(S) 
at(C) 
strtod(S) 
strtoKS) 
strtoKS) 
sdget(S) 
reboot (C) 
autoreboot (C) 
awk(C) 
wait(C) 
finc(M) 
ckbup3cd(M) 
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Permuted Index 



trec(M) recover files from a 
badblock(C) add new bad sectors to the 
badblock(C) add new 
bad sector map 

164a(S} convert between long integer and 
of pathnames 
time at(C) 
language 
diff 
cb(CP) 

bessel(S) jO(S) yO(S) 



bfs(C) scan 
fwrite(S) fread(S) 
whereis(C) locate source, 
bsearch(S) 

tflnd(SJ tdelete(S) twall<(S) manage 
creatsemlS) create a 
reset (C) reset the teletype 
ssp(C) remove consecutive 
sync(S) update super 
df(M) report number of free disk 
sum(C) calculate checksum and count 
boot(M) 

mkboot(M) convert object file to 
table inkunix(M) make 
table mkunix(M) make 



shutdown(M) 
multiuser (C) singleuser (C) 
allocation 
table 

stdio(S) standard 
setbuf(S) setvbuf(S) assign 
mknod(C) 
bsh(C) invoke the 
digest(C) create menu systemCs) for the 
menus (M) format of 
swab(S) swap 
cc(CP) invoke the 
xcc(CF) invoke the XENIX 
cflow(CP) generate 
cpp(CP) the 
lint (CP) check 
cxref(CP) generate 
ctrace(CP) 
cb(CP) beautify 
xref(CP) cross-reference 
xstr(CF) extract strings from 
list (CP) produce 
create an error message file from 
create an error message file from 



back-up tape 

bad sector map 

bad sectors to the bad sector map 

badblock(C) add new bad sectors to the 

banner(C) print large letters 

base-64 ASCII string a641(S) 

basename(C) dlrname(C) deliver portions 

batch (C) execute commands at a later 

bc(C) arbitrary-precision arithmetic 

bdiff(C) compare files too large for 

beautify C programs 

Bessel functions 



bessel(S) JO(S) yO(S) Bessel functions 

bf3(C) scan big files 

big files 

binary input /output 

binary, or manual for program 

binary search of a sorted table 

binary search trees tsearch(S) 

binary semaphore 

bit 



blank lines 
block 



blocks and inodes 
blocks in a file 
boot program 



bootable object file 



frec(M) 

badblock(C) 

badblock(C) 

badblock(C) 

banner (C) 

a641(S) 

basename(C) 

at(C) 

bc(C) 

bdiff (C) 

cb(CP) 

bessel (S) 

bessel (S) 

bfs(C) 

bfs(C) 

fwrite(S) 

whereis (C) 

bsearch(S) 

tsearch(S) 

creatsem(S) 

reset (C) 

S8p(C) 

sync ( S ) 
df (M) 
sum(C) 
boot(M) 
mkboot(M) 
mkunix(M) 



bootable system file with driver symbol 
bootable system file with kernel symbol _ mkunix(M) 

boot(M) boot program boot(M) 

brc(M) system initialization procedure brc(M) 

bring system to single-user or shutdown _ shutdown(M) 

bring system up multi/single-user mode multiuser (C) 

brk(S) 8brk(S) change data segment space brk(S) 
bsearch(S) binary search of a sorted 

bsh(C) invoke the Business shell 

buffered input/output package 

buffering to a stream 

build special files 

Business shell 

Business shell 



Business shell menu system 

bytes 

C compiler 

C compiler 



C flow graph 

C Language Preprocessor 

C language usage and syntax 

C program cross-reference 

C program debugger 

C programs 

C programs 

C programs 



C source listing from COFF file 

C source mkstr(C) 

C source mkstr(CP) 

cal(C) print a calendar 



bsearch(S) 
bsh(C) 
stdio(S) 
setbuf (S) 
mknod(C) 
bsh(C) 
digest (C) 
menus (H) 
swab ( S ) 
cc(CP) 
_xcc(CP) 
oflow(CP) 
cpp(CP) 
lint (CP) 
cxref (CP) 
ctrace(CP) 
cb(CP) 
xref (CP) 
xstr(CP) 
list (CP) 
mkstr(C) 
mk8tr(CF) 
cal(C) 
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Permuted Index 



file suin(G) 
dc(C) arbitrary precision 
cal(C) print a 

cu(C) 

stat(F) return data by stat system 
inalloc(S) mallinfoCS) mallept(S) 
lntro(5) introduce system 
line printer lp.(<C) 
temc8p(M) terminal 
tecminee(W) terminal 
description 
asaCC) i-nterpret aM 



gencc(G{>) ersate a front end to the 



sees delta 

absolute value funotiens floor (^) 
floor (S) ceil(S) f«b8(S) floor. 

floor(S) emocKS) floor, 

string ctime(S) tzset(5) asctime(S) 
brk(S) 8brk(S) 
pa«SHd(C) 
chnodCS) 
putenvCS) 
ciiewn(S) 
chown(C) ehgrp(C) 
directory ehiiiod(C) 
nice(S) 
chroot(S) 
chroot (C) 

of file* settine(C> 
delta cdc(eP) 
chslze(S) 
delta(CP) make a 
cd(C) 
chdd.r(S) 

pipe(S) create an Interprocess 
<uigetc(S) push 
cuaerld(S) get 
getc(S) getw(S) fgetefS) gotchar(S) get 
putc(S) putchar(S) putw<S) tpute(S) put 
aacli(M) map of the ASCII 
fgrep(C) aaaxch a file for a 
asa(e) interpret aaa carriage control 
toascil(S) tolower(S) tramslate 
islower(S) Iscntrl(S) classify 
ispunct(S) Isascii(S) classify 
tr(C) tranalate 
wc(C) count lines, words, and 

waltsem(S) nbwaitsem(S) wait and 
fsck(C) dfsck(C) 



calculate checksum and count blocks in 

calculator 

calendar 

calendar(C) invok« a reminder service 

call another UNIX system ■ 

call 

calloe(S) fa»t main memory alloicator 

calls, functions, and libraries 



cancel (C) send/cancel requests to LP 

capability database 

capability database 



c^toinfsCW convert termcap to terminfo 
ear-rlage control characters 



catCC) concatenate and diaplay files 

<^(CP) beautify e programs 

cc command 



cc(€P) invoke the C compiler 

cd(C) ohange working directory 

cdc(eP) ohange the delta commentary of 

ceil(S) fabs(S) floor, ceiling, and 

ceilxBg. and absolute value functions 
oelllng. and absolute value functions 

cflow(QP) generate C flow graph 

cftime(S) convert date and time to 

change data segment space allocation 

change login password 

change mode of file 



change or add value to environment 

change owner and group of a file 

change owner or group ID 



change permissions of a file or 

change priority of a process 

change root directory 



change root directory for command 

change swap device configuration 

change t-he access and modification dates 

ehange the delta commentary of SCCS 

change the file size 

change to an SCCS file 

change working directory 

ohange working directory 

channel 

character back into input stream 

character login name of the user 

character or word fron a stream 

character or word on a stream 

character set 

character string 

characters 



characters conv(S) toupper(S) 
characters ctype(S) isalpha(S) 
characters ctype(S) isdiglt(S) 

characters 

characters 



chdir(S) change working directory 
check access to semaphore resource 
check and repair file systems 



sum(C) 
dc(C) 
cal(C) 
calendar (C) 
cu(C) 
Stat (F) 
malice (S) 
intro(S) 
lp(C) 

termcap(M) 

terminfo(N) 

captoinfo(M) 

asa(C) 

cat(C) 

cb(CP) 

gencc(CP) 

cc(eP) 

cd(C) 

cdc(CP) 

floor(S) 

floor (S) 

floor(S) 

cflow<CP) 

ctime(S) 

brk(S) 

passwd(e) 

chmod(S) 

putenv(S) 

chown(S) 

chown(e) 

chmod(C) 

nice(S) 

chroot (S) 

chroot (C) 

swap(e) 

settime(C) 
. cdc(CP) 

chslze(S) 
_ delta(eP) 
. cd(e) 

chdir(S) 
_ pipe(S) 

ungetc(S) 

cuserld(S) 

getc(S) 

putc(S) 
_ ascli(M) 
fgrep(C) 
asa(C) 
conv(S) 
ctype(S) 
ctype(S) 
_ tr(C) 
_ wc(C) 
_ chdir(S) 
waitsem(S) 
fsck(e) 
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lint (CP) 
cl<bupacd(M) 
pHck(M) grpck(M) 
permissions tile uucheck(M) 
rdchk(S) 

labelit(M) copy file aystem with label 
by fsck 
suin(C) calculate 
chown(C) 

times (S) get process and 
wait(S) wait for 
provide access to the time-of-day 
libraries 
directory 



ID 



file 
command 



schedule 

isalpha(S) i8loHer(S) iscntrl(S) 
isdigit(S) ispunct(S) iaaacil(S) 
inir(M) 

strclean(M) STREAMS error logger 
uucleanup(M) uucp spool directory 
clri(M) 
clear(C) 

inquiries ferror(S) fileno(S) 
csh(C) shell command interpreter with 
alarm(S) set a process alarm 
time-of-day chip 

STREAMS driver 
Idclose(S) Idaclose(S) 
close ( S ) 
fclose(S) fflush(S) 
haltsys(C) 

directory operations directory(S) 



dis(CP) object 
Idclose(S) Idaclose(S) close a 
Idfhread(S) read the file header of a 
llst(CF) produce C source listing from 
to line number entries of a section of a 
to relocation entries of a section of a 
an indexed/named section header of a 
the index of a symbol table entry of a 
read an indexed symbol table entry of a 
seek to the symbol table of a 
remove symbols and line numbers from 
convert an object file from OMF to 
manipulate line number entries of a 
Idgetname(S) retrieve symbol name for 



check C language usage and syntax 
check file aystem backup schedule 

check password/group file 

check the uucp directories and 



check to see if there is data to be read 
checking volcopy(M) 



lint (CP) 
ckbupacd(M) 
pwck(H) 
uucheck(M) 
rdchk(S) 
volcopy(M) 
checklist (M) 
stun(C) 
chown(C) 
times (S) 
wait(S) 
clock(M) 

chk8hlib(CP) tool for comparing shared chkahlib(CP) 

chmod(C) change permissions of a file or chmod(C) 

chmod(S) change mode of file chmod(S) 

chown(C) 



checklist (M) list file systems processed 

checksum and count blocks in a file 

chgrp(C) change owner or group ID 

child process times 



child process to stop or terminate 
chip clock(M) 



chown(C) chgrp(C) change owner or group 

chown(S) change owner and group of a 

chroct(C) change root directory for 

chroot(S) change root directory 

chsize(S) change the file size 

ckbupscd(M) check file system backup 

classify characters ctype(S) 

classify characters ctype(S) 



clean the file system and executes init 

cleanup program 

cleanup 

clear Inode 



clear terminal screen 

clear(C) clear terminal screen 

clearerr(S) feof(S) stream status 

C-like syntax 

clock 



clock (M) provide access to the 

clock(S) report CPU time used 

clone (M) open any minor device on 
close a COFF file 



close a file descriptor 

close or flush a stream 

close the file systems and halt the CPU 

closedlrCS) rewlnddir(S) •eekdir(S) 

close(S) close a file descriptor 

clri(M) clear inode 

cmp(C) compare two files 

code disassembler 

COFF file 

COFF file 

COFF file 

COPF file Idlseek(S) seek 

COFF file ldr8eek(S) seek 

COFF file Idshread(S) read 

COFF file Idtbindex(S) compute 

COFF file Idtbread(S) 

COFF file Idtbseek(S) 

COFF file strip(CP) 

COFF fixobj(CP) 



COFF function Idlread(S) Idlitem(S) 
COFF symbol table entry 



chown ( S ) 
chroot (C) 
chroot(S) 
chsize(S) 
ckbupscd(M) 
ctype(S) 
ctype(S) 
inir(M) 
strclean(M) 
uucleanup(M) 
clri(M) 
clear (C) 
clear(C) 
ferror (S) 
csh(C) 
alann(S) 
clock (M) 
clock ( S ) 
clone (H) 
Idclose(S) 
close(S) 
fclose(S) 
haltsys(C) 
directory (S) 
close(S) 
clri(M) 
cmp(C) 
dis(CP) 
Idclose(S) 
Idfhread(S) 
list (CP) 
Idlseek(S) 
Idrseek(S) 
Idshread(S) 
Idtbindex(S) 
Idtbread(S) 
Idtbseek(S) 
. strip(CP) 
fixobj (CP) 
Idlread(S) 
Idgetname(S) 
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comb (CP) 
nice(C) run a 
chroot(C) change root directory for 
env(C) set environment for 
gencc(CP) create a front end to the cc 
nohup(C) run a 
aetp9rp(C) execute 
sh(C) rsh(C) invoke the shell 
csh(C) shell 
uux(C) execute 
getopt(C) parse 
uuxqt(M) execute remote 
aystem(S) issue a shell 
time(C) time a 
at(C) batch(C) execute 
cron(C) execute 
rc2(M) 

install (M) install 
intro(0 introduce 
intro(CP) introduce software development 
rcO(M) 

xargs(C) eonstruet and execute 
two sorted files 
mcs(CP) manipulate the object file 



comb (CP) combine SCCS deltas 
combine SCCS deltas 



command at a different priority 
command 



command execution 
command 



command immune to hangups and quits 

command in a new process group 

command interpreter 



comb (CP) 

comb(CP) 

nice(C) 

chroot(C) 

env(C) 

gencc(CP) 

nohup(C) 

Betpgrp(C) 

sh(C) 



cemnand interpreter with C-like syntax csh(C) 



command on remote UNIX 

command options 

command requests 

command 

coomand 



comnands at a later time 

commands »t specified times 

eomnands for multi-user environment 

commands 

commands 

commands 



csm«»nds to stop the operating system 

comnands 

conni(C) select/reject lines common to 



comment section 



cdc(CP) change the delta 


commentary of 


Idfcn(F) 


connen 


object 


cprs(CP) compresse a 


eemmen 


object 


Idopen(S) Idaopen(S) open a 


eomnen 


object 


linenum(F) line number entries in a 


conB»n 


object 


nffl(CP) print name list of 


eoimon 


object 


reloc(F) relocation of information for a 


ceoaon 


object 


scnhdr(F) section header for a 




object 


symB(F) 


OMMBOn 


object 


conv(CP) convert 


cenmon 


object 


filehdr(F) file header for 


cenmon 


object 


size(C) print section sizes of 


ceonen 


object 


seek to the optional file hiead»r ef a 


camaen 


object 


coinn(C) select/reject lines 


cenwn 


to two 


glossary(C) define 


cemnen 


UNIX t< 



ipcs(C) report inter-process 
stdipc(S) ftok(S) standard interprocess 
diramp(G) 
sdiff (C) 
bdiff (-C) 
infoemp(M) 
diff3(C) 
cmp(C) 
diff (C) 
sccsdif«(CP) 
chk8hlib(CP) tool f»r 
reg«mp(S) 

r«aexp{F) regular e3q)ression 
routines re9exp(S) 
re«enp(eP) 

tic(C) 

cc(CP) invoke the C 



eemaunication facilities status 

eommunication package 

compare directories 



compare files side-by-side 

compare files too large for diff 

compare or print terminfo descripti 

compare three files 

compare two files 



compare two text files 

compare two versions of an SCCS file 

eofflpariny shared libraries 

compile a regular mpression 

compile and match routines 



compile regular expression and match 

compile regular expressions 

eompile terminfo source 

compiler 



uux<C) 

getopt(C) 

uuxqt (H) 

system(S) 

time(C) 

at(C) • 

cron(C) 

rc2(M) 

install (M) 

intro(C) 

intro(CP) 
. rcO(M) 

xargs(C) 

comiit(C) 

mcs(CP) 
_ cdc(CP) 
. Idecn(F) 

cprs(CP) 

Idopen(S) 

linenujii(F) 

nm(CP) 

reloc(F) 

scnhdr(F) 

syms(F) 

conv(CP) 

filehdr(F) 

size(C) 
. Idohseek(S) 

conra(C) 

glossary (C) 

ipcs(C) 

atdipc(S) 

dircmp<C) 
_ sdiff (C) 
. bdiff (C) 

iHfocmp(M) 
_ diff3(C) 

cmp(C) 
_ diff(C) 

sccsdiff (CP) 

chkshlib(CP) 

regcmp(S) 

regexp(F) 

regexp(S) 

regcmp(CP) 
_ tic(C) 

cc(CP) 
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xcc(CP) invoke the XENIX C 
yacc(CP) Invoke a 
erf(S) erfc(S) error function and 
wait(C) wait 
pack(C) pcat(C) unpack(C) 
cprs (CP) 

entry of a COFF file Idtbindex(S) 
cat(C) 
Idunix(M) 
master (N) master 
printers (M) print spooler 
sysconf(C) get system 
sysconf(S) get system 
pconfig(C) set port 
swap(C) change swap device 
shutype(N) UPS shutdown 
Ipadmin(M) 

establish an out-going terminal line 
ssp(C) remove 
system 
system 

math(F) math functions and 
unistd(F) file header for symbolic 
ile header for implementation-specific 
mkfs(M) 
xargs (C) 
uutry(H) 

errprint(M) display error log 
recover (C) restore 
dump.hd(C) dump 
ls(C> list 

csplit(C) split files according to 
fcntl(S) file 
uadmin(S) administrative 
uustat(C) UUCP status inquiry and job 
vc(CP) version 
asa(C) interpret asa carriage 
ioctl(S) 

IEEE floating point environment 
IEEE floating point environment 
IEEE floating point environment 
IEEE floating point environment 
IEEE floating point environment 
init(M) process 
msgctl(S) message 
seaictl(S) semaphore 
■hBCtl(S) shared memory 
fcntl(F) file 

term(M) 
fixobj(CP) 
dd(C) 
ranlib(CP) 
integers 13tol(S) ltol3(S) 
ASCII string a641(S) 164a(S) 
conv(CP) 

ctime(S) gmtime(S) localtime(S) 



compiler-compiler 

complementary error function 

completion of background processes 
compress and expand files 



compress a common object file 

compute the index of a symbol table 

concatenate and display files 

configurable kernel linker 

configuration database 

configuration file 

configuration information 

configuration information 

configuration 

configuration 



configuration utility ' 

configure the LP spooling system 

connection dial(S) 

consecutive blank lines 

console display 

console keyboard 

constants 

constants 



constants limits(F) 

construct a file system 

construct and execute comnanda 

contact remote system with debugging 

contents 

contents of a file system from tape _ 

contents of a hard disk to tape 

contents of directories 

context 

control 

control 

control 

control 

control characters 

control device 



control fpgetround(S) fpgetmask(S) 

control fpgetround(S) fpgetstlcky(S) 
control fpgetround(S) fpsetmask(S) 

control fpgetround(S) fpsetround(S) 
control fpgetround(S) fpsetstlcky(S) 

control initialization 

control operations 

control operations 

control operations 

control options 



conv(CP) convert cosmon object files 
conventional names for terminals 



convert an object tile from OMF to COFF 
convert and copy a file 



convert archives to random libraries 

convert between S-byte integers and long 
convert between long integer and base- 64 

convert cocrnion object files 

convert date and tiae to string 



xcc (CP) 

yacc ( CP ) 

erf (S) 

wait(C) 

pack ( C ) 

cprs (CP) 

Idtbindex(S) 

cat(C) 

Idunix(M) 

master (M) 

printers (M) 

sysconf (C) 

sysconf (S) 

pconf ig(C) 

swap(C) 

ahutype(M) 

Ipadmin(M) 

dial(S) 

ssp(C) 

display(M) 

keyboard (M) 

math(F) 

unistd(F) 

limits(F) 

mkfs(H) 

xargs (C) 

uutry(M) 

errprint(M) 

recover (C) 

dump. hd(C) 

ls(C) 

c8plit(C) 

fcntl(S) 

uadmin(S) 

uustat (C) 

vc(CP) 

aBa(C) 

ioctl(S) 

fpgetround(S) 

fpgetround(S) 

fpaetround(S) 

fpgetround(S) 

fpgetround(S) 

init(H) 

msgctl(S) 

semctl(S) 

shmctl(S) 

fcntl(F) 

conv(CP) 

term(H) 

fixobj(CP) 

dd(C) 

ranlib(CP) 

13tol(S) 

a641(S) 

conv(CP) 

ctime(S) 
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ctlme(S) tzset(S) asctime(S) cftiine(S) 
ecvt(S) 

scanf(S) f scant (S) 88canf(S) 
file iiikboot(M) 
FORTRAN rat for (CP) 
number strtod(S) atot(S) 
strtol(S) atol(S) atoi(S) 
captoinfo(M) 
units (C) 
translate characters 
dd(C) convert and 
fcopy (C) 
cplo(C) 

volcopy(M) labellt(H) 
cp(C) 

uucp(C) uulog(C) uunaine(C) 
copY(C) 
tra(C) 

public UNIX-to-UNIX system file 
core(F) format of 
slnh(S) 

trigonometric functions trig(S) sln(S) 
sum(C) calculate checksum and 
wo(C) 

cpio(F) format of 



close the file systems and halt the 
clock (S) report 
creatsemO) 
gencc{CP) 
tmpnam(S) tempnam(S) 
one creat(S) 
fork(S) 
mkshllb(CP) 
ctaga(C) 
tee(C) 
tmptlle(S) 
source mkstr(C) 
source mkstr(CP) 
pipe(S) 
admin (CP) 
Shell digest (C) 
makedevs(M) 
makettys (M) 
umask(S) set and get file 
existing one 



convert date and tine to string 



times 

crontab(C) manage user 



ctlme(S) 
ecvt ( S ) 
scanf (S) 
mkboot(M) 
ratfor(CP) 
strtod(S) 
strtol(S) 
captoinfo(M) 
units(C> 
conv(S) 
dd(C) 
fcopy(C) 
cpio(C) 
volcopy (M) 
cp(C) 
uucp(C) 
copy(C) 
tra(C) 
uuto(C) 
copy(C) 
core(F) 
core(F) 
ainh(S) 
trig(S) 
sum(C) 
wc(C) 
cp(C) 
cplo(F) 
cplo(C) 
cpio(F) 
cpp(CP) 
cprs(CP) 
cpset(C) 
haltsys(C) 
clock (S) 
creatsem(S) 
gencc(CP) 
tmpnam(S) 
creates ) 
fork(S) 
mkshlib(CP) 
ctags(C) 
tee(C) 
tmpflle(S) 
mkatr(C) 
mkstr(CP) 
plpe(S) 

admin (CP) 

create menu s;stem(s) for the Business digest (C) 

create special device files makedevs(M) 

create tty special files makettys (M) 

creation mask umask(S) 

creat(S) create a new file or reorlte an creat(S) 

creatsem(S) create a binary semaphore creatsem(S) 

cref(CP) make a cross-reference listing _ cref (CP) 

cron(C) execute comnanda at specified cron(C) 

crontab files crontab(C) 



convert floating-point number to string 

convert formatted input 

convert object file to bootable object 

convert rational FORTRAN to standard 

convert string to double-precision 

convert string to Integer 

convert termcap to termlnfo description 

convert units 

conv(S) toupper(S) toascii(S) tolower(S) 

copy a file 

copy a floppy diskette 

copy file archives in and out 

copy file system with label checking 

copy files 

copy files from UNIX to UNIX 

copy groups of files 

copy out a file as it grows 

copy uuto(C) uuplck(C) 

copy(C) copy groups of files 

core image file 

core(F) format of core image file 

cosh(S) tanh(S) hyperbolic functions 

cos(S) tan(S) asln(S) acos(S) 

count blocks in a file 

count lines, words, and characters 

cp(C) copy files 

cpio archive 

cplo(C) copy file archives in and out 

cpio(F) format of cpio archive 

cpp(CP) the C Language PreprocesBor 

cpr8(CP) conpresse a comnx>n object file 

cpsat(C) install utilities 

CPU h«ltsy8(C) 

CPU time used 

create a binary semaphore 

create a front end to the cc command 

create a name for a temporary file 

create a new file or rewrite an existing 

create a new process 

create a shared library 

create a tags file 

create a tee in a pipe 

create a temporary file 

create an error message file from C 

create an error message file from C 

create an Interprocess channel 

create and aaainlster SCCS files 
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xref (CP) 

cxref(CP) generate C program 
cref(CP) make a 
functions 
C-like syntax 
context 



terminal 
date and time to string 
convert date and time to string 

iscntrl(S) classify characters 
isascii(S) classify characters 

tty(C) get the 
aact(CP) print 
uname(C) print the 
uname(S) get name of 
whoaini(C) print effective 
find the slot in the utmp file of the 
getcwd(S) get path name of 
scr_dump(r) format of 
optimization package 
spline(C} interpolate smooth 
the user 
cross-reference 
Ipd(H) line printer 
strerr(M) STREAtIS error logger 
xpd(M) transparent printer 
sdgetv(S) sdwaitv(S) synchronize shared 
turn on/off 
stat(F) return 
plock(S) lock process, text, or 
prof (CP) display profile 
execseg(S) make a 
synchronize access to a shared 
sdfree(S) attach and detach a shared 
brk(S) sbrk(S) change 
sputl(S) sgetl(S) access long integer 
rdchk(S) check to see if there is 
types (F) primitive system 
query terminfo 
dbminit(S) fetch(S) nextkey(S) perform 
firstkey(S) store(S) fetch(S) perform 
master(M) master configuration 
termcap(H) terminal capability 
terminfo (M) terminal capability 
ctime(S) gmtime(S) localtlme(S) convert 
tzset(S) asctime(S) cftime(S) convert 
date(C) print and set the 

change the access and modification 
database functions dboi(S) 
perform database functions 
perform database functions 



crontab(C) manage user crontab files 

cross-reference C programs 

cross-reference 



cross-reference listing 

crypt (S) password and file encryption 
csh(C) shell command interpreter with 

csplit(C) split files according to 

ctags(C) create a tags file 

ct(C) spawn getty to a remote terminal 
ctermid(S) generate file name for 



crontab(C) 
xref (CP) 
cxref (CP) 
cref (CP) 
crypt(S) 
csh(C) 
cspllt (C) 
ctags(C) 
ct(C) 

ctermld(S) 
ctime(S) 
ctime(S) 
ctrace(CP) 
ctype(S) 
ctype(S) 
cu(C) 
tty(C) 
sact (CP) 
uname(C) 
unante ( S ) 
whoami ( C } 
ttyBlot(S) 
getcwd(S) 
scr_dump(F) 
curses (S) 
spline (C) 

cuserid(S) get character login name of cuserid(S) 



ctime(S) gmtlme(S) localtime(S) convert 
ctlme(S) tzset(S) asctlme(S) cftime(S) 

ct race (CP) C program debugger 

ctype(S) Isalpha(S) lalower(S) 

ctype(S) isdigit(S) ispunct(S) 

cu(C) call another UNIX system 

current port name 



current SCCS file edit activity 

current UNIX information 

current UNIX system 

current user id 



current user ttyslot(S) 

current working directory 

curses screen image file 

curses (S) terminal screen handling and 
curves 



cxref (CP) generate C program 

daemon 

daemon 

daemon 

data access 



data collector 

data by stat system call 

data in memory 

data 



data region executable 

data segment sdenter(S) sdleave(S) 
data segment sdget(S) 



data segment space allocation 
data 



data to be read 

data types 

database 



database functions dbm(S) 
database functions dbm(S) 

database 

database 

database 



date and time to string 

date and time to string ctlme(S) 
date 



date(C) print and set the date 
dates of files settime(C) 



dbninit(S) fetch(S) nextkey(S) perform 
dbn(S) dbmlnit(S) fetch(S) nextkey(S) 
dbm(S) flr«tkey(S) store(S) fetch(S) 



cxref ! CP j 

Ipd(M) 

strerr(M) 

xpd(H) 

sdgetv(S) 

sadcon(M) 

stat(F) 

plock(S) 

prof (CP) 

exec8eg(S) 

adenter (S) 

sdget(S) 

brk(S) 

sputl(S) 

rdchk(S) 

types(F) 

tput(C) 

dbm(S) 

dbm(S) 

master(M) 

terracap(M) 

terminfo(M) 

ctime(S) 

ctlme(S) 

date(C) 

date(C) 

settlme(C) 

dbm(S) 

dbm(S) 

dbm(S) 
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adb(C} invoke x.out general purpose 
ct race (CP) C program 
f*db(M) tile system 
sdb(C) symbolic 
uutry(M) contact remote system with 
default (M) 
tlmezone(H) set 
directory 
glossary (C) 
sysdef(M) output system 
basename(C) dirname(C) 
tall(C) 

change the delta commentary of SCCS 
cdc(CP) change the 
rmdel(CP) remove a 

comb (CP) combine SCCS 
errstop(C) terminate error-logging 
captoinfo(M) convert termcap to termlnfo 
infocmp(H) compare or print termlnfo 
closeO) close a file 
dup(S) dup2(S) duplicate an open file 
sdget(S) adfree(S) attach and 
access ( S ) 
dtype(C) 
file(C) 
fstyp(M) 
drive sizefs(C) 
whodo(N) 

Intro(CP) introduce software 
SHap(C) change swap 
malcedeva(M) create special 
fold long lines for finite width output 
devlnfo(C) display 
loctl(S) control 
devnm(C) Identify 
clone (M) open any minor 

files reside 
and Inodes 
fsck(C) 
line connection 
bdlff(C) compare tiles too large tor 



nlce(C) run a coonand at a 
Business Shell 

uucheck(M) check the uucp 
dlrcnp(C) compare 
fleece(C) look for tiles In home 
unlink(M) link and unlink tiles and 
ls(C) list contents of 
mv(C) move (rename) files and 
rra(C) rmdir(C) remove files or 



dc(C) arbitrary precision calculator 

dd(C) convert and copy a file 

debugger 

debugger 

debugger 

debugger 

debugging on 



dc(C) 
dd(C) 
adb(C) 
ctrace(CP) 
fsdb(M) 
sdb(C) 
uutry(M) 
default (M) 
timezone(H) 

default (M) default program information default (M) 



default program information directory 
default system time zone 



define common UNIX terms and symbols 
definition 



deliver portions of pathnames 

deliver the last part of a tile 
delta cdc(CP) 



delta commentary of SC(^ delta 
delta from an SCCS file 



delta(CF) make a change to an SCCS file 

deltas 

demon 

description 

descriptions 

descriptor 

descriptor 

detach a shared data segment 

determine accessibility of a file 

determine disk type 

determine file type 



determine the file system identifier 
determine the size of a logical disk 

determine who is doing what 

development commands 

device configuration 

device tiles 

device told(C) 

device information 

device 

device name on which files reside 

device on STREflMS driver 



glossary (C) 
sysdef (M) 
basename(C) 
tail(C) 
cdc(CP) 
cdc(CP) 
rmdel(CP) 
delta(CP) 
comb (CP) 
errstop(C) 
captoinfo(M) 
infocmp(M) 
close (S) 
dup(S) 
sdget(S) 
access (S) 
dtype(C> 
file(C) 
t8typ(M) 
sizefs(C) 
whodo(H) 
Intro (CP) 
swap(C) 
makedevs(M) 
fold(C) 
devinfo(C) 
ioctl(S) 
devnm(C) 
clone(H) 
devinto(C) 
devnm(C) 



devinto(C) display device Infomatlon 
devnii)(C) identity device name on which 
df(M) report number of free disk blocks _ df (M) 

dfsck(C) check and repair file systems tsck(C) 

dlal(S) establish an out -going terminal _ dlal(S) 



ditt 

ditt3(C) compare three files 

dlff(C) compare two text files 
different priority 



digest (C) create menu systen(s) for the 

dlrcmp(C) compare directories 

directories and pemlsslons tile 

directories 

directories 



bdiff (C) 
diff3(C) 
diff (C) 
nice(C) 
digest (C) 
dlrcmp(C) 
uucheck(M) 
dircmp(C) 



directories link(M) 

directories 

directories 

directories 



tie 

linkiMi 
ls(C> 
mv(C) 
rm(C) 



IC) 
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cd(C) change working 
chdi.r(S) change working 
chmod(C) change permissions of a file or 
chroot ( S ) change root 
uucleanup(M) uucp spool 
default (M) default program information 
dir(M) format of a 
getdents(S) read 
dirent(F) file system independent 
unlink (S) remove 
chroot (C) change root 
get path name of current working 
nikdlr(C) make a 
mkdir(S) make a 
pHd(C) print working 
closedir(S) rewinddir(S) seekdir(S) 
telldir(S) readdir(S) opendir(S) 
mknod(S) make a 
rmdir(S) remove a 
seekdir(S) directory operations 
opendir(S) directory operations 
directory entry 

basename(C) 
disable(C) 
acct(S) enable or 

mesg(C) allow or 
dis(CF) object code 
set terminal type, modes, speed, line 

add.hd(C) add an additional hard 
df (M) report number of free 
determine the size of a logical 
restore. hd(C) restore a hard 
options (M) floppy 
layout (H) manage hard 
maintain 

dump.hd(C) dump contents of a hard 
dtype(C) determine 
upgrade. hd(C) upgrade an additional hard 
du(C) sunmarize 
fcopy(C) copy a floppy 
fomat(C) format a floppy 
system console 
see(C) 
devinfo(C) 

vi(C) invoke a screen-oriented 
errprint (H) 
cat(C) concatenate and 

hd(C) 
od(C) 
prof (CP) 

set up terminal to print screen 
hdr(C) 
who(C) 

hypot(S) Euclidean 



directory 

directory 

directory 

directory 

directory cleanup 

directory 

directory 



directory entries and put 

directory entry 

directory entry 

directory for command 

directory getcwd(S) 

directory 

directory 



directory name 

directory operations directory(S) 

directory operations directory(S) 

directory, or a special or ordinary file 

directory 

directory(S) closedir(S) rewinddir(S) 

directory (S) telldir(S) readdir(S) 

dirent(F) file system independent 

dir(M) format of 



directory 



dirname(C) deliver portions of pathnames 

disable logins on a port 

disable process accounting 



disable(C) disable logins on a port 
disallow messages sent to a terminal 
disassembler 



discipline uugetty(M) 

dis(CP) object code disassembler 
disk 



disk blocks and Inodes 

disk drive sizets(C) 

disk from tape 



disk installation menu 

disk partitions 

disk partitions 

disk to tape 

disk type 

disk 

disk usage 

diskette 

diskette 

display 



display a file 

display device information 
display editor 



display error log contents 
display files 



display files In hexadecimal format 

display files in octal format 

display profile data 

display pscreen(C) 



display selected parts of an object file 

display who is on the system 

distance function 



cd(C) 

chdlr(S) 

chmod(C) 

chroot (S) 

uucleanup (M) 

default (M) 

dir(M) 

getdent3(S) 

dirent(F) 

unlink (S) 

chroot (C) 

getcwd(S) 

mkdlr(C) 

mkdir(S) 

pwd(C) 

directory (S) 

directory (S) 

mknod(S) 

rmdir(S) 

directory (S) 

directory (S) 

dirent(F) 

dir(M) 

basenametC) 

disable(C) 

acct(S) 

disable(C) 

mesg(C) 

di8(CP) 

uugetty(M) 

dls(CP) 

add.hd(C) 

df (M) 

sizefs(C) 

restore. hd(C) 

options (M) 

layout (M) 

fdlsk(C) 

dump.hd(C) 

dtype(C) 

upgrade. hd(C) 

du(C) 

fcopy(C) 

format (C) 

display(M) 

see(C) 

devlnfo(C) 
. vi(C) 

errprint (M) 
. cat(C) 
. hd(C) 
_ od(C) 
_ prof (CP) 

pscreen(C) 

hdr(C) 
_ who(C) 

hypot(S) 
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whodo(M) determine who is doing what 



UNIX 

strtod(S) atof(S) convert string to 
pseudo-random numbers 
lrand48(S) generate pseudo-random/ 
jrand48(S) generate pseudo-random/ 
graph (C) 
manufacturing drive(C) 
determine the size of a logical disk 
utility program for a streaming tape 
during manufacturing 
open any minor device on STREAMS 
mkunix(M) make bootable system file with 



dump. hd(C) 
dump (CP) 
object file 
to tape 
descriptor dup(S) 
dup(S) dup2(S) 
descriptor 

drive(C) drive information written 
echo(C) 

string 

ed(C) red(C) invoke the 
program end(S) 

sact(CP) print current SCCS file 
edit(C) Invoke the 

ed(C) red(C) invoke the ed text 
edit(C) invoke the edit text 
ex(C) invoke a text 
Id (CP) invoke the link 
a.out(F) format of assembler and link 
8ed(C) Invoke the atrean 
vi(C) invoke a screen-oriented display 
xld(CP) invoke the link 
whoami(C) print 
full regular expression 
enable(C) 
acct(S) 

Ipenable(C) Ipdlsable(C) 
crypt (S) password and file 
raakekey(M) generate an 
gencc((n>) create a front 
entry aetgrent(S) fgetgrent(S) 
file entry getpwent(S) fgetpwent(S) 
in program 

getut(S) getutent(S) utmpnarae(S) 

getdents(S) read directory 
xlist(S) fxllst(S) get name list 



dos(C) access MS-DOS files 

dos disk partitions 

double-precision number 



drand48(S) erand48(S) generate _ 
drand48(S) mrand48(S) nrand48(S) 
drand48(S) seed48(S) srand48(S) 
draw a graph 



drive information written during 

drive sizefs(C) 

drive tapeutil(C) 



drlve(C) drive information written 

driver clone (H) 

driver symbol table 



dtype(C) determine disk type 
du(C) sumnarize disk usage 



dump contents of a hard disk to tape _ 
dump selected parts of an object file 
dump(CF) dump selected parts of an 



dump.hd(C) dump contents of a hard disk 

dup2(S) duplicate an open file 

duplicate an open file descriptor 



whodo(M) 

dos(C) 

fdisk(C) 

strtod(S) 

drand48(S) 

drand48 ( S 1 

drand48 ( S ) 

graph (C) 

drive (C) 

sizefs(C) 

tapeutil(C) 

drive (C) 

clone(M) 

mkunix(M) 

dtype(C) 

du(C) 

dump.hd(C) 
dump(CF) 
dump(CP) 
dump.hd(C) 

. dup(S) 

. dup(S) 



dup(S) dup2(S) duplicate an open file dup(S) 

during manufacturing drive (C) 

echo arguments echo(C) 

echo(C) 
ecvt(S) 

ed(C) 

end(S) 

ed(C) 

sect (CP) 

edit(C) 

edit(C) 

ed(C) 

edit(C) 

_ ex(C) 

Id(CP) 

a.out(F) 

sed(C) 

_ vi(C) 

xld(CP) 

whoami(C) 

egrep(C) 

enable(C) 

acct(S) 

enable (C) 

Ipenable(C) 

crypt (S) 

makekey(M} 

gencc(CP) 

endgrent(S) setgrent(S) get group file getgrent(S) 

endpwent(S) setpwent(S) get password getpwent(S) 

end(S) edata(S) etext(S) last locations _ end(S) 

endutent(S) access utnp file entry getut(S) 

enroll (C) 
getdents(S) 
xlist(S) 



echo(C) echo arguments 

ecvt(S) convert floating-point number to 

ed text editor 

edata(S) etext(S) last locations in 

ed(C) red(C) invoke the ed text editor 

edit activity 

edit text editor 

edit(C) invoke the edit text editor 

editor 

editor 

editor 

editor 

editor output 

editor 

editor 

editor 

effective current user id 

egrep(C) search file for pattern using 

enable logins on a port 

enable or disable process accounting 

enable(C) enable logins on a port 

enable/disable LP line printers 

encryption functions 

encryption key 

end to the cc comnand 



enrolKC) xsend(C) xget(C) secret mail 

entries and put In a file 

entries frosi tiles 
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nllat(S) get 
llnenu]n(F) line number 
Idlltem(S) manipulate line number 
Idlaeek(S) aeek to line number 
Idraeek(S) aeek to relocation 
utmp(H) wtmp(M) format of utmp and wtmp 
file system independent directory 
endgrent(S) setgrent(S) get group file 
getgrnam(S) getgrgld(S) get group file 
setpwent(S) get password file 
getpwuid(S) get password file 
utmpname(S) endutent(S) access utmp file 
getutline(S) access utmp file 
symbol name for COFF symbol table 
compute the index of a symbol table 
Idtbread(S) read an indexed symbol table 
putpwent(S) write password file 
unlink (S) remove directory 
execution 

proflle(H) set up 
fpgetmask(S) IEEE floating point 
fpgetsticky(S) IEEE floating point 
fpsetmaskCS) IEEE floating point 
fpsetround(S) IEEE floating point 
fpsetsticky(S) IEEE floating point 
environ (M) user 
env(C) Bet 
getenv(S) return value for 
printenv(C) print out the 
putenv(S) change or add value to 
rc2(M) commands for multi-user 
numbers drand48(S) 
error function erf(S) 
complementary error function 
sys_nerr ( S ) sys_errlist ( S ) 
function erf(S) erfc(S) 
erfc(S) error function and complementary 
errprint (M) display 
strclean(M) STREAMS 
■trerr(M) STREAMS 
log(M) interface to STREAMS 
mkstr(C) create an 
akstr<CP) create an 
perror(S) system 
sys_errllat (S) ermo(S) system 
find spelling 
matherr(S) 
errstop(C) terminate 



connection dial(S) 
setmnt(C) 
setmnt(C) establish 
end(S) edata(S) 
hypot(S) 
test(C) 



entries from name list 

entries in a common object file 

entries of a COFF function Idlread(S) 

entries of a section of a COFF file 

entries of a section of a COFF file 

entries 

entry dirent(F) 

entry getgrent(S) fgetgrent(S) 

entry getgrent(S) 



entry /f getpwent (S) endpwent(S) 

entry getpwent(S) getpwnam(S) 

entry getut(S) getutent(S) 

entry getut(S) aetutent(S) 

entry Idgetname(S) retrieve 

entry of a COFF file Idtbindex(S) 

entry of a COFF file 

entry 

entry 



env(C) set environment for comnand 

environ (M) user environment 

environment at login time 



environment control fpgetround(S) 
environment control f pgetround(S) 
environment control fpgetround(S) 
environment control f pgetround(S) 
environment control f pgetround(S) 
environment 



environment for comnand execution 
environment name 

environment 

environment 

environment 



•rand48(S) generate pseudo-random 

•rfc(S) error function and complementary 

•rf(S) erfc(S) error function and 

•rmo(S) system error messages 



•rror function and complementary error 

•rror function erf(S) 

error log contents 



error logger cleanup program 

error logger daemon 

error logging 



error message file from C source 
error message file from C source 
error messages 



error messages sys_nerr(S) 
errors 



error-handling function 
error-logging demon 



errprint (M) display error log contents _ 
errstop(C) terminate error-logging demon 

establish an out-going terminal line 

establish /etc/mnttab table 

/etc/mnttab table 



etext(S) last locations in program 

Euclidean distance function 

evaluate an expression 



nll8t(S) 

linenum<F) 

Idlread(S) 

Idlseek(S) 

Idrseek(S) 

utmp(M) 

dirent(F) 

getgrent(S) 

getgrent(S) 

getpwent ( S ) 

getpwent (S) 

getut(S) 

getut(S) 

Idgetname(S) 

Idtbindex(S) 

Idtbread(S) 

putpwent ( S ) 

unlink (S) 

env(C) 

environ (M) 

profile (M) 

fpgetround(S) 

fpgetround(S) 

fpgetround(S) 

fpgetround(S) 

fpgetround(S) 

environ (M) 

env(C) 

getenv(S) 

prlntenv(C) 

putenv ( S ) 

rc2(M) 

drand48(S) 

erf (S) 

erf (S) 

sys_nerr(S) 

erf(S) 

erf(S) 

errprint (M) 

strclean(H) 

atrerr(M) 

. log(M) 

. mkstr(C) 
mkstr(CP) 
perror(S) 
sys_nerr(S) 
spell (C) 
matherr(S) 
errstop(C) 
errprint (M) 
err8top(C) 
dial(S) 
setmnl iC) 
SetniiiC IC) 

. end(S) 
hypot ( S) 
test (C) 
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expr(C) 

file exec(S) execvp(S) execlp(S) 
execute a file exec(S) execvp(S) 
execvp(S) execlp(S) execle(S) execv(S) 
execv(S) execKS) execute a file 

execseg(S) make a data region 
execlp(S) execle(S) execv(S) execKS) 
regex(S) 
setpgrp(C) 
uux(C) 
at(C) batch(C) 
cron(C) 

xargs(C) construct and 
uuxqt (M) 

inir(M) clean the file system and 
env(C) set environment for command 
nap(S) suspend 
sleep(C) suspend 
sleep (S) suspend 
monitor (S) prepare 
prof IKS) 

execl(S) execute a file exec(S) 
exec(S) execvp(S) execlp(S) execle(S) 
creat(S) create a new file or rewrite an 
false (C) return with a nonzero 
true(C) return with a zero 

pack(C) pcat(C) unpack(C) compress and 
functions exp(S) pow(S) log(S) 
functions exp(S) sqrt(S) 
expression 
regexp(S) compile regular 
regexp(F) regular 
file for pattern using full regular 
expr(C) evaluate arguments as an 
regcmp(S) compile a regular 
regex(S) execute a regular 
test(C) evaluate an 
regcnp(CP) compile regular 
logarithm, and power functions 
and square root functions 
x8tr(CP) 

value functions floor (S) cell(S) 
report inter-process coasiunication 
help(C) system help 
f actor (C) 

value 
ff (M) 
flnc(M) 

malloc(S) free(S) realloc(S) 
malllnfo(S) mallopt(S) calloc(S) 
abort (S) generate an lOT 
stream 



evaluate arguments as an expression 

ex(C) invoke a text editor 

execle(S) execv(S) execKS) execute a 
execlp(S) execle(S) execv(S) execKS) 
execl(S) execute a file exec(S) 



exec(S) execvp(S) execlp(S) execle(S) 

execseg(S) make a data region executable 

executable 

execute a file exec(S) execvp(S) 

execute a regular expression 



execute command in a new process group 

execute command on remote UNIX 

execute commands at a later time 

execute commands at specified times 

execute commands 



expr(C) 
ex(C) 
exec ( S ) 
exec ( S ) 
exec(S) 
exec(S) 
execseg(S) 
execseg(S) 
exec(S) 
regex(S) 
setpgrp(C) 
uux(C) 
. at(C) 
cron(C) 
xargs(C) 
uuxqt (M) 
. Inlr(M) 
env(C) 
nap(S) 
sleep(C) 
sleep(S) 
monitor (S) 
. profiKS) 
exec(S) 
exec(S) 
. creat(S) 
false (C) 
true(C) 
. exlt(S) 
pack(C) 
. exp(S) 
. exp(S) 
expr(C) 
regexp(S) 

•Kpression compile and match routines regexp(F) 



execute remote command requests 

executes inlt 

execution 



execution for a short interval 

execution tor an interval 

execution for interval 

execution profile 

execution time profile 



execvp(S) execlp(S) execle(S) execv(S) 

execv(S) execKS) execute a file 

existing one 

exit value 

exit value 



exit(S) terminate process 
expand files 



exponential, logarithm, and power 

exponential, logarithm, and square root 

•>pr(C) evaluate arguments as an 

•xpresslon and match routines 



expression egrep(C) search 

expression 

expression 

expression 

expression 

expressions 



egrep(C) 
expr(C) 
regcmp ( S ) 
regex(S) 
test(C) 
regcmp ( CP ) 
exp(S) 



exp(S) pow(S) log(S) exponential, _ 
exp(S) sqrt(S) exponential, logarithm, exp(S) 



extract strings from C programs 

fabs(S) floor, ceiling, and absolute 

facilities status ipcs(C) 

facility 



factor a number 

factor(C) factor a number 

false(C) return with a nonzero exit 
fast find 



fast incremental backup 

fast main memory allocator 

fast main memory allocator malloc(S) 

fault 

fclose(S) fflush(S) close or flush a 
fcntl(F) file control options 



xstr(CP) 
floor (S) 
ipcs(C) 
help(C) 
factor(C) 
factor(C) 
false(C) 
. ff(M) 
finc(M) 
malloc(S) 
malloc(S) 
abort (S) 
fclose(S) 
fcntl(F) 
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UNIX DOS disk partition* 
topen(S) 

Intro (M) introduce miscellaneous 
ferror(S) fileno(S) clearerr(S) 
stream status inquiries 
functions dbin(S) dbminit(S) 
dbm(S) firstkey(S) store(S) 
head(C) print the first 
fcloae(S) 

word from a stream getc(S) getH(S) 
group file entry getgrent(S) 
password file entry getpwent(S) 
gets(S) 
string 
utime(S) set 
Idfcn(F) common object 
access(S) determine accessibility of a 
acct(M) format of per-process accounting 
cpio ( C ) copy 
tra(C) copy out a 
chmod(S) change mode of 
chown(S) change ovmer and group of a 
mcs(CP) manipulate the object 
fcntl(S) 
fcntl(F) 

uupick(C) public UNIX-to-UNIX system 
core(F) format of core image 
cprs(CP) compresse a common object 
umask(S) set and get 
ctagB(C) create a tags 
dd(C) convert and copy a 
delta (CP) make a change to an SCCS 
close (S) close a 
dup(S) dup2(S) duplicate an open 
dump selected parts of an object 
sact(CP) print current SCCS 
crypt (S) password and 
endgrent(S) setgrent(S) get group 
getgrnam(S) getgrgid(S) get group 
endpwent(S) setpwent(S) get password 
getpwnam(S) getpwuid(S) get password 
utmpname(S) endutent(S) access utmp 
setutent(S) getutline(S) access utmp 
putp«ent(S) write password 
execle(S) execv(S) exacKS) execute a 
fgrep(C) search a 
grep(C) search a 
expression egrep(C) search 
Idaopen(S) open a common object 
ar(F) archive 
xar(F) archive 
intro(F) Introduction to 
mkstr(C) create an error message 
mkstrCCP) create an error message 



fcntl(S) file control 

fcopy(C) copy a floppy diskette 

tdisk(C) 

fdopen(S) freopen(S) open a stream 

features and files 

feof(S) stream status inquiries 



ferror(S) tileno(S) clearerr(S) feof(S) 

fetch(S) nextkey(S) perform database 

fetch(S) perform database functions 

few lines of a stream 



fflush(S) close or flush a stream 

ff(M) fast find 

fgetc(S) getchar(S) get character or 

fgetgrent(S) endgrent(S) 8etgrent(S) get 
fgetpwent(S) endpwent(S) setpwent(S) get 

fgets(S) get a string from a stream 

fgrep(C) search a file for a character 

file access and modification times 

file access routines 

file 

file 

file archives in and out 

file as it grows 

tile 

file 



file comment section 
file control 



file control options 

file copy uuto(C) 

file 

file 



file creation mask 

fli« 

file 

file 



file descriptor 

file descriptor 

file dump(CP) 

file edit activity 

file encryption functions 

file entry getgrent(S) fgetgrent(S) 
file entry getgrentfS) 



file entry getpwent(S) fgetpwent(S) 
file entry getpwent(S) 



file entry getut(S) getutent(S) 

file entry getut(S) 

file entry 



file exec(S) execvp(S) execlp(S) 

file for a character string 

file for a pattern 



file for pattern using full regular 

file for reading Idopen(S) 

file format 

file format 

file formats 

file from C source 

file from C source 



fcntl(S) 

fcopy(C) 

fdlsk(C) 

fopen(S) 

Intro(M) 

f error (S) 

ferror(S) 

dbm(S) 

dbm(S) 

head(C) 

fclose(S) 

ff (M) 

getc(S) 

getgrent(S) 

getpwent (S) 

gets(S) 

fgrep(C) 

utlme(S) 

Idfcn(F) 

access (S) 

acct(M) 

cplo(C) 

tra(C) 

chmod(S) 

chown(S) 

mcs(CP) 

fcntl(S) 

fcntl(F) 

uuto(C) 

core(F) 

cprs(CP) 

umask(S) 

ctags(C) 
. dd(C) 

delta(CP) 

close (S) 
. dup(S) 

dump(CP) 

sact(CP) 

crypt (S) 

getgrent(S) 

getgrent(S) 

getpwent (S) 

getpwent (S) 

getut(S) 

getut(S) 

putpwent(S) 

exec(S) 

fgrep(C) 

grep(C) 

egrep(C) 

Idopen(S) 
. ar(F) 

xar(F) 

intro(F) 

mkstr(C) 

mkstr(CP) 
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header for symbolic constants 

header of a COFF file 

header of a conmon object 

into pieces 



Idahread(S) read the 



Idtbindex(S) compute the 

Idtbread(S) read 

Idtbseek(S) 

linenum(F) 



mknod(S) make 

name for terminal 



f ixobj (CP) convert an object file from OMF to COFF 

get (CP) got a version of an SCCS file 

read directory entries and put in a file getdents(S) 

group (M) format of the group file 

display selected parts of an object file hdr(C) 

filehdr(F) tile 

constants limits (F) file 

uniatd(F) file 

Idfhread(S) read the file 

Idohseek(S) seek to the optional file 

split (C) split a file 

archive header of a member of an archive file 

Idclose(S) Idaclose(S) close a COFF file 

read the file header of a COFF file 

number entries of a section of a COFF file 

entries of a section of a COFF file 

indexed/named section header of a COFF file 

index of a symbol table entry of a COFF file 

an indexed symbol table entry of a COFF file 

seek to the symbol table of a COFF file 

line number entries in a common object file 

link(S) link to a file 

produce C source listing from COFF file 

ln(C) make a link to a file 

mem(M) kmem(N) memory image file 

convert object file to bootable object file 

a directory, or a special or ordinary file 

ctermid(S) generate file 

mktemp(S) make a unique file 

nl(C) add line numbers to a file 

nm(CF) print name list of common object file 

null(H) null file 

ttyslot(S) find the slot in the utmp file 

more(C) view a file 

chmod(C) change permissions of a file 

fuser(H) identify processes using a file 

creat(S) create a new file 

pas8Wd(M) password file 

for CRTs file 

fseek(S) ftell(S) rewind(S) reposition a tile 

Iseek(S) move read/write file 

printers (M) print spooler configuration file 

prs(CP) print an SCCS file 

pwck(H) grpck(M) check password/group file 

read(S) read from file 

locking(S) lock/unlock a file 

of information for a cosaaon object file 

rev(C) reverse lines of a file 

rmdel(CP) remove a delta from an SCCS file 

compare two versions of an SCCS file sccsdiff(CP) 

sccsfile(F) format of an SCCS file 

section header for a coanon object file scnhdr(F) 

format of curses screen image file acr_dump(F) 

see(C) display a file 

chsize(S) change the file size 

stat(S) tstat(S) get file status 

find the printable strings in an object file strings (C) 



tixobj (CP) 
get (CP) 
getdents(S) 
group (M) 
hdr(C) 
filehdr(F) 



header for comnon object files 
header for implementation-specific _ limits(F) 



Idf bread (S) 

Idlseek(S) seek to line 

Idrseek(S) seek to relocation 
Idshread(S) read an 



of the current user 

one full screen at a time 
or directory 



or file structure 

or rewrite an existing one 



perusal filter 

pointer in a stream 
pointer 



region for read/write 
reloc(F) relocation 



unistd(F) 
Idfhread(S) 
Idohseek(S) 
split (C) 
Idahread(S) 
Idclose(S) 
Idfhread(S) 
Idlseek(S) 
Idrseek ( S ) 
Idshread(S) 
Idtbindex(S) 
Idtbread(S) 
Idtbseek(S) 
llnenum(F) 
link(S) 
list (CP) 
ln(C) 
mem(M) 
mkboot(M) 
mknod(S) 
ctermid(S) 
mktemp(S) 
. nl(C) 
nm(CP) 
null(M) 
ttyslot(S) 
more(C) 
chmod(C) 
fu8er(H) 
crest (S) 
passwd(M) 

. pg(C) 

fseekCS) 

. Iseek(S) 
printers (M) 

. prs(CP) 
pwck(n) 
read(S) 
locklng(S) 
reloc(F) 

. rev(C) 

_ rmdel(CP) 
sccsdiff(CP) 
sccsfile(F) 
8cnhdr(F) 
3cr_cluiiip(F) 
see(C) 
chsize(S) 

, stat(S) 
strings (C) 
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symbols and line numbers from COFF 
identify processes using * file or 

mount (C) umount(C) mount/unmount a 
calculate checksum and count blocks in a 
syms(F) common object 
Inir(M) clean the 
ckbupscd(H) check 
fsdb(M) 

recover (C) restore contents of a 
fsinfo(M) report information about a 
fstyp(M) determine the 
dirent (F) 
statfs(S) fstatfs(S) get 
mkfs(M) construct a 
mount (S) mount a 
quot(C) summarize 
ustat(S) get 
fsstat(M) report 
fstab(M) 
mnttab(M) mounted 
archive(C) save a 
sysfs(S) get 
volcopy(M) labelit(M) copy 
haltsys(C) close the 
fsck(C) dfsck(C) check and repair 
labelit(C) provide labels for 
umountall(C) mount /unmount multiple 
checklist (M) list 
tail(C) deliver the last part of a 
tmpfile(S) create a temporary 
tempnam(S) create a name for a temporary 
mkboot(M) convert object 
tsort(C) sort a 
access and modification times of a 
uucico(M) 

uusched(M) scheduler for the uucp 
ftw(S) walk a 
ttys(M) login terminals 
file(C) determine 
unget(CP) undo a previous get of an SCCS 
unig(C) report repeated lines in a 
the uucp directories and permissions 
val(CP) validate an SCCS 
mkunix(N) make bootable system 
mkunlJc(M) make bootable system 
write(S) write on a 

umask(C) set 
files 

status inquiries ferror(S) 
c»plit(C) split 
admin (CP) create and administer SCCS 
link(M) unlink(M) link and unlink 
mv(C) move (rename) 
aftp(C) transfer 
bfs(C) scan big 
cat(C) concatenate and display 



tile strip(CP) reawve _ 
file structure fuser(M) 

file structure 

file 8um(C) 



file symbol table format 

file system and executes init 

file system backup schedule 

file system debugger 

file system from tape 

file system 



file system identifier 

file system independent directory entry 

file system information 

file system 

file system 



file system ownership 
file system statistics 

file system status 

file system table 

file system table 



file system to a streaming tape 

file system type information 

file system with label checking 

file systems and halt the CPU 

file systems 

file systems 



file systems mountalKC) 

file systems processed by fsck 

file 

file 



file tmpnam(S) 

file to bootable object file 

file topologically 

file touch(C) update 



file transport program for uucp system 

file transport program 

file tree 

file 

file type 

file 

file 

file uucheck(M) check 

file 



file with driver symbol table 
file with kernel symbol table 
file 



file(C) determine tile type 
file-creation mode mask 



filehdr(F) file header for coosion object 

flleno(S) clearerr(S) feof (S) stream 

files according to context 

files 

files and directories 

files and directories 

files between Altos machines 

files 

files 



strip(CP) 
fuser(H) 

mount (C) 

suffl(C) 

syms (F) 

inir(H) 

ckbupscd(M) 

fsdb(M) 

recover (C) 

fsinfo(M) 

fstyp(M) 

dirent (F) 

statfs(S) 

mkfs(N) 

mount (S) 

quot(C) 

ustat(S) 

fsstat(H) 

fstab(M) 

mnttab(M) 

archive(C) 

sysfs(S) 

volcopy(M) 

haltsys(C) 

fsck(C) 

labellt(C) 

mountalKC ) 

checklist (M) 

tail(C) 

tmpfile(S) 

tmpnam ( S ) 

mkboot(H) 

tsort(C) 

touch (C) 

uucico(M) 

uusched(M) 

ftw(S) 

ttys(M) 

file(C) 

unget(CP) 

uniq(C) 

uucheck(M) 

val(CP) 

mkunix(M) 

mkunix(M) 

write(S) 

. file(C) 
umask(C) 
filehdr(F) 
ferror(S) 

. csplit(C) 
admin (CP) 
link(M) 

. mv(C) 

. aftp(C) 

. bfs(C) 
cat(C) 
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c«ip<C) compare two 
select /reject lines common to two sorted 
conv(CP) convert coinnon object 
copy(C) copy groups of 
cp(C) copy 
crontab(C) manage user crontab 
dift3(C) compare three 
dlff(C) compare two text 
dos(C) access MS-DOS 
filehdr(F) file header for common object 
find(C) find 
hplp(C) hplpR(C) filter 
trec(H) recover 
uucp(C) uulog(C) uuname(C) copy 
fspec(F) format specification in text 
f split (CP) split ratfor 
hd(C) display 
fleece(C) look for 
od(C) display 
introduce miscellaneous features and 
lockf (S) record locking on 
makedevs(M) create special device 
makettys(M) create tty special 
mknod(C) build special 
pr(C) print 
nn(C) rmdir(C) remove 
pcat(C) unpack(C) compress and expand 
devnm(C) identify device name on which 
the access and modification dates of 
sdif f ( C ) compare 
print section sizes of common object 
sort (C) sort and merge 
tar(C) archive 
Ipr(C) route named 
bdiff(C) compare 
what(C) identify 
fxlist(S) get name list entries from 



printer hplp(C) hplpR(C) 



ff(H) fast 
find(C) 
finger(C) 
look(C) 
ttynaM(S) isatty(S) 
library lorder(CP) 
file strings (C) 
current user ttyslot(S) 



fold(C) fold long lines for 
database functions dfan(S) 
OMF to COFF 
directories 
fpgetround(S) fpgetmask(S) IEEE 
epgetround(S) fpgetsticky(S) IEEE 



files 

files coinii(C) 

files 

files 

files 

files 

files 

files 

files 

files 

files 



files for printing on LaserJet printer 

files from a back-up tape 

files from UNIX to UNIX 

files 

files 



files in hexadecimal format 

files in home directories 

files in octal format 

files in tro{M) 

files 

files 

files 

files 



files on the standard output 

files or directories 

files pack(C) 

files reside 



cmp(C) 
comm(C) 
conv(CP) 
copy(C) 
cp(C) 

crontab (C) 
diff3(C) 
diff (C) 
dos(C) 
tilehdr(F) 
find(C) 
hplp(C) 
frec(H) 
uucp(C) 
fspec(F) 
f split (CP) 
hd(C) 
fleece (C) 
od(C) 
intro(M) 
lockf (S) 
makedevs(M) 
makettys(M) 
mknod(C) 
. pr(C) 
rm(C) 
pack(C) 
devnm(C) 
settime(C) 
. sdiff(C) 
size(C) 
sort(C) 
. tar(C) 
. Ipr(C) 
bdiff (C) 
what(C) 
xlist(S) 
filesystem(H) 
. pg(C) 
. hplp(C) 
finc(M) 
. ff(M) 
find(C) 
finger (C) 
look(C) 
ttyname(S) 
lorder(CP) 
strings(C) 
tty8lot(S) 
find(C) 
. finger (C) 
fold(C) 

firstkey(S) store(S) fetch(S) perform dbm(S) 

fixobj(CP) convert an object file from fixobj(CP) 

fleece (C) look for files in hone fleece (C) 

floating point environment control f pgetround(S) 

floating point environment control rpgetround(S) 



files settime(C) change 

files side-by-side 

files size(C) 

files 

files 



files to printer spooler 
files too large for dlff 
files 



files xlist(S) 

f ilesystem(M) format of a system volume 
filter file for CRT 



filter files for printing on LaserJet 

finc(M) fast incremental backup 

find 

find files 



find information about users 
find lines in a sorted list 
find name of a terminal 



find ordering relation for object 

find the printable strings in an object 

find the slot in the utnp file of the 

rind(C) find files 



finger(C) find information about users 
finite width output device 
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tpgetround(S) Cpaetniasic(S) IEEE 
fpgetround(S) tpBetround(S) IEEE 
tpgetround(S) tp«etsticky (S) IEEE 
isnan(S) isnanf(S) i3nand(S) test for 
ecvt(S) convert 
modf(S) Idexp(S) manipulate parts of 
functions floor(S) ceil(S) fabs(S) 
functions floor (S) fmod(S) 
and absolute value functions 
absolute value functions 
options (M) 
fcopy(C) copy a 
format (C) format a 
cflow(CP) generate C 
fclose(S) fflush(S) close or 
value functions floor (S) 

device fold(C) 
output device 
stream 

format (C) 
ar(F) archive file 
hd(C) display files in hexadecimal 
od(C) display files in octal 
dir(N) 
filesystem(M) 
inode(H) 
sccaf ile(F) 
output a.out(F) 
menus (M) 
core(F) 
cpio(F) 
scr_d\imp(F) 
acct(H) 
group(M) 
utmp(H) wtmp(M) 
fspec(F) 

syins(F) common object file symbol table 
xar(F) archive file 

intro(F) introduction to file 
scanf(S) fscanf(S) sscanf(S) convert 
vprintf(S) vfprintf(S) vsprintf(S) print 
printf(S) sprintf(S) tprlntf(S) print 
tiit(C) simple text 
convert rational FORTRAN to standard 
rat for (CP) convert rational 
environment control fpgetround(S) 
point environment control 
floating point environment control 
point environment control 
floating point environment control 
floating point environment control 
environment control fpgetround(S) 
printf(S) sprintf(S) 
environment control fpgetround(S) 



floating point environment control 

floating point environment control 

floating point environment control 

floating point NaN 



floating-point number to string 

floating-point numbers frexp(S) 

floor, ceiling, and absolute value 

floor, ceiling, and absolute value 

floor (S) ceil(S) fabs(S) floor, ceiling, 

floor(S) fraod(S) floor, ceiling, and 

floppy disk installation menu 

floppy diskette 

floppy diskette 

flow graph 

flush a stream 

fmod(S) floor, ceiling, and absolute 

fmt(C) simple text formatter 



fold long lines for finite width output 
fold(C) fold long lines for finite width 

fopen(S) fdopen(S) freopen(S) open a 

fork(S) create a new process 

format a floppy diskette 

format 

format 

format 

format of a directory 

format of a system volume 

format of an inode 

format of an SCCS file 



format of assembler and link editor 
format of Business Shell menu system 

format of core image file 

format of cplo archive 



format of curses screen image file 

format of per-process accounting file 
format of the group file 



format of utmp and wtmp entries 

format specification in text files 

format 

format 



format (C) format a floppy diskette 
formats 



formatted input 

formatted output of varargs list 

formatted output 

formatter 



FORTRAN rat for (CP) 

FORTRAN to standard FORTRAN 

fpgetmask(S) IEEE floating point 

fpgetround(S) fpgetmask(S) IEEE floating 
fpgetround(S) fpgetstlcky(S) IEEE 



fpgetround(S) fpsetmask(S) IEEE floating 

fpgetround(S) fpBetround(S) IEEE 

fpgetround(S) fp8etsticky(S) IEEE 

fpgetsticky(S) IEEE floating point 

fprintf(S) print formatted output 

fpsetmask(S) IEEE floating point 



fpgetround(S) 

fpgetround(S) 

fpgetround(S) 

isnan(S) 

ecvt(S) 

frexp(S) 

floor (S) 

floor (S) 

floor (S) 

floor (S) 

options (M) 

foopy(C) 

format (C) 

cflow(CP) 

fclose(S) 

floor (S) 

fmt(C) 

fold(C) 

fold(C) 

fopen(S) 

fork(S) 

format (C) 

ar(F) 

hd(C) 

od(C) 

dir(M) 

filesystem(M) 
inode (M) 
sccsfile{F) 
a.out(F) 
menus (F4) 
core(F) 
cpio(F) 
scr_dump(F) 
acct(M) 
group (M) 
utmp(H) 
fspec(F) 
syms(F) 
xar(F) 
format (C) 
intro(F) 
scanf(S) 
vprintf(S) 
printf(S) 
. fmt(C) 
rat for (CP) 
rat for (CP) 
fpgetround(S) 
fpgetround(S) 
fpgetround(S) 
fpgetround(S) 
fpgetround(S) 
fpgetround(S) 
f pgGtround(S) 
printf(S) 
fpgetround(S) 
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environment control fpgetround(S) 
environment control fpgetround(S) 
stream putc(S) putchar(S) putw(S) 
puts(S) 
fwrite(S) 
tape 

df (M) report number of 
allocator malloc(S) 
fopen(S) fdopen(S) 
parts of floating-point numbers 

gencc(CP) create a 
input Bcanf(S) 
list file systems processed by 
systems 

file pointer in a stream 
file system 
files 



statfs(S) 
stat(S) 
identifier 
pointer in a stream fseek(S) 
communication package stdipc(S) 

egrep(C) search file for pattern using 
more(C) view a file one 
function ert(S) erfc(S) error 
error function and complementary error 
gamna(S) log gamma 
hypot(S) Euclidean distance 
manipulate line number entries of a COFF 
matherr(S) error-handling 
prof(F) profile within a 
math(F) math 
intro(S) introduce system calls. 
bessel(S) jO(S) yO(S) Bessel 
crypt (S) password and file encryption 
fetch(S) nextkey(S) perform database 
store(S) fetch(S) perform database 
log(S) exponential, logarithm, and power 
exponential, logarithm, and square root 
floor, ceiling, and absolute value 
floor, ceiling, and absolute value 
sinh(S) cosh(S) tanh(S) hyperbolic 
trig(S) atan(S) atan2(S) trigonometric 
tan(S) asin(S) acos(S) trigonometric 
or file structure 

files xlist(S) 
gannia(S) log 

conmand 
adb(C) invoke x.out 



fpsetround(S) IEEE floating point 
fpaetsticky(S) IEEE floating point 
fputc(S) put character or word on a 
fputs(S) put a string on a stream 
fread(S) binary input /output 



frec(M) recover files from a back-up 
free disk blocks and inodes 



tree(S) realloc(S) fast main memory 
freopen(S) open a stream 



frexp(S) modf(S) Idexp(S) manipulate 

from(C) list who my mail is from 

front end to the 



command 



fscsnf(S) ascanfCS) convert formatted 
fsck checklist (H) 



fsck(C) dfsck(C) check and repair file 

fsdb(M) file system debugger 

fseek(S) ftell(S) rewind(S) reposition a 

fsinfo(M) report information about a 

fspec(F) format specification in text 

f split (CP) split ratfor files 

fsstat(H) report file system status 

fstab(M) file system table 



fstatfs(S) get file system information 
fstat(S) get file status 



fstyp(H) determine the file system 

ftell(S) rewind(S) reposition a file 

ftok(S) standard interprocess 

ftw(S) walk a file tree 

full regular expression 

full screen at a time 



function and complementary error 

function erf(S) erfc(S) 

function 

function 



function Idlread(S) Idlitem(S) 

function 

function 



functions and constants _ 
functions, and libraries 

functions 

functions 



functions dbm(S) dbminit(S) 

functions dbm(S) flrstkey(S) 

functions exp(S) pow(S) 

functions exp(S) sqrt(S) 



functions floor(S) ceil(S) fabs(S) 

functions floor(S) fmod(S) 

functions 

functions 



functions trig(S) sin(S) cos(S) 

fuser(H) identify processes using a file 

fwrite(S) fread(S) binary input/output 

fxlist(S) get name list entries from 

ganna function 

gamia(S) log ganaia function 



gencc(CP) create a front end to the cc 
general purpose debugger 



fpgetround(S) 

fpgetround(S} 

putc(S) 

put3(S) 

fwrite(S) 

frec(M) 

df (M) 

malloc(S) 

f open ( S ) 

frexp(S) 

from(C) 

gencc(CP) 

scanf (S) 

checklist (M) 

fsck(C) 

fsdb(M) 

fseek(S) 

fsinfo(M) 

fspec(F) 

f split (CP) 

fsstat(M) 

fstab(M) 

8tatfs(S) 

stat(S) 

fstyp(M) 

f3eek(S) 

stdipc(S) 

ftw(S) 

egrep(C) 

more(C) 

erf(S) 

erf (S) 

gainna(S) 

hypot(S) 

Idlread(S) 

matherr ( S ) 

prof (F) 

math(F) 

intro(S) 

bessel (S) 

crypt (S) 

dbm(S) 

dbm(S) 

exp(S) 

exp(S) 

floor (S) 

floor (S) 

sinh(S) 

trig(S) 

trig(S) 

fuser(H) 

fwrite(S) 

xlist(S) 

gamma(S) 

gamma (S) 

gence(CP) 

adb(C) 
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termio(M) 
random (C) 
inkver8(CP) 
inakekey(M) 
abort (S) 
cflow(CP) 
cxref (CP) 
ctermlcKS) 
ncheck(M) 
lex (CP) 

drand4e(S) erand48(S) 
/inrand48(S) nrand48(S) lrand48(S) 
/seed48(S) arand48(S) Jrand48(S) 
rand(S) srand(S) simple random-number 
stream getc(S) oetH(S) feetc(S) 

character or word from a stream 
working directory 
put In a file 
group IDs getuld(S) 
name 

group IDs getuid(S) 
group IDs getuid(S) 
setgrent(S) get group file entry 
group file entry 
getgrent(S) getgrnam(S) 
entry getgrent(S) 



argument vector 

and parent process IDs 
setpwent(S) get password file entry 
password file entry 
file entry getpwent(S) 

getpwent(S) getpwnam(S) 
Input 
stream 

speed and terminal settings used by 
ct(C) spawn 
used by getty 

user or group IDs 
user or group IDs 
user or group IDs 
access utmp file entry getut(S) 
getut(S) setutent(S) 
endutent(S) access utmp file entry 
utmp file entry 
character or word from a stream getc(S) 
login (C) 
symbols 

time to string ctlme(S) 
setjmp(S) longjmp(S) non-local 
cflow(CP) generate C flow 



general terminal Interface 

generate a random number 

generate a what string 

generate an encryption key 

generate an lOT fault 

generate C flow graph 



generate C program cross-reference 
generate file name for terminal 



generate path names from Inode numbers _ 
generate programs for lexical analysis _ 

generate pseudo-random numbers 

generate pseudo-random numbers 

generate pseudo-random numbers 

generator 

getchar(S) get character or word from a 

get (CP) get a version of an SCCS file 

getc(S) getw(S) fgetc(S) getchar(S) get 
getcwd(S) get path name of current 



getdents(S) read directory entries and 

getegid(S) get real/effective user or 

getenv(S) return value for environment 

geteuid(S) get real/effective user or 

getgld(S) get real/effective user or j 

getgrent(S) fgetgrent(S) endgrent(S) 

getgrent(S) getgrnam(S) getgrgid(S) get 
getgrgid(S) get group file entry 



Setgrnam(S) getgrgid(S) get group file 
getlogin(S) get login name 



getmsg(S) get next message off a stream 

getopt(C) parse coasund options 

getopt(S) get option letter from 

getpas(S) read a password 

getpld(S) get process, process group, 

getpwent(S) fgetpwent(S) endpwent(S) 

getpwent(S) getpwnam(S) getpwuid(S) get 

getpwnam(S) getpwuid(S) get password 

getpw(S) get name from UID 



getpwuld(S) get password file entry 

geta(C) get a string from the standard 

gets(S) fgets(S) get a string from a 

getty gettydefs(M) 

getty to a remote temlnal 

gettydefs(N) speed and terminal settings 
getty(M) set terminal mode 



getuld(S) getegld(S) get real/effective 
getuid(S) geteuid(S) get real/effective 
getuld(S) getgld(S) get real/effective 

getutent(S) utmpnane(S) endutent(S) 

getutline(S) access utmp file entry 

getut(S) getutent(S) utmpname(S) 



getut(S) setutent(S) getutllne(S) access 

getw(S) fgetc(S) getchar(S) get 

give you system access 



glos8ary(C) define coomon UNIX terms and 
gmtlme(S) localtlme(S) convert date and 

goto 

graph 



termio(M) 

random (C) 

mkvers ( CP ) 

makekey(M) 

abort (S) 

cflow(CP) 

cxref (CP) 

ctermid(S) 

ncheck(H) 

lex (CP) 

drand48(S) 

drand48(S) 

drand48(S) 

rand(S) 

getc(S) 

get (CP) 

getc(S) 

getcwd(S) 

getdents(S) 

getuld(S) 

getenv(S) 

getuid(S) 

getuid(S) 

getgrent (S) 

getgrent (S) 

getgrent (S) 

getgrent (S) 

getlogin(S) 

getmsg(S) 

getopt(C) 

getopt(S) 

getpas(S) 

getpld(S) 

getpwent (S) 

getpwent ( S ) 

getpwent ( S ) 

getpw(S) 

getpwent ( S ) 

gets(C) 

gets(S) 

gettydefs(M) 

ct(C) 

gettydefs(M) 

getty(M) 

getuld(S) 

getuld(S) 

getuld(S) 

getut(S) 

getut(S) 

getut(S) 

getut(S) 

getc(S) 

login (C) 

glossary (C) 

ctime(S) 

set jmp(S) 

cflow(CP) 
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graph (C) draw a 
plot(S) 

getpld(S) get process, process 
Cgetgrent(S) endgrent(S) setgrent(S) get 
getgrent(S) getgrnain(S) getgrgld(S) get 
group(M) format of the 
ld(C) print user and 
chown(C) chgrp(C) change ovmer or 
setpgrp(S) set process 
getegid(S) get real/effective user or 
geteuld(S) get real/effective user or 
getgid(S) get real/effective user or 
setuid(S) set user and 
newgrp(C) log user into a new 
chown(S) change owner and 
kill(S) send a signal to a process or a 
execute command in a new process 

copy(C) copy 

make(C) maintain, update, and regenerate 
tra(C) copy out a file as it 
pwck(M) 
ssignal(S) 

haltsys(C) close the file systems and 
halt the CPU 
varargs(F) 
curses(S) terminal screen 
nohup(C) run a coomand iiimune to 
add.hd(C) add an additional 
restore. hd(C) restore a 
layout (N) manage 
dump.hd(C) dump contents of a 
upgrade. hd(C) upgrade an additional 
find spelling errors 
find spelling errors 
hsearch(S) hdestroy(S) hcreate(S) manage 
generate 
hsearch(S) hdestroy(S) 
format 

search tables hsearch(S) 
object file 
stream 
scnhdr(F) section 
fllehdr(F) file 
Constanta lijiilts(F) file 
unistd(F) file 
Idfhread(S) read the file 
read an indexed/named section 
Idohseek(S) seek to the optional file 
Idahread(S) read the archive 
help(C) system 

hd(C) display files in 
fleece(C) look for files In 
printing on LaserJet printer 



graph (C) draw a graph 

graphics interface subroutines 

grep(C) search a file for a pattern 

group, and parent process IDs 

group file entry getgrent(S) 

group file entry 

group file 



group ID and names 

group ID 

group id 



group IDs getuld(S) 
group IDs getuid(S) 
group IDs getuid(S) 

group IDs 

group 



group of a file 

group of processes 
group setpgrp(C) 



group (H) format of the group file 

groups of files 

groups of programs 

grows 



grpck(H) check password/group file 

gslgnal(S) software signals 

halt the CPU 



haltsys(C) close the file systems and 

handles variable argument list 

handling and optimization package 

hangups and quits 

hard disk 



hard disk from tape 
hard disk partitions 

hard disk to tape 

hard disk 

hashcheck(C) 

hashmake(C) 



hash search tables 

hashing encryption 

hcreate(S) manage hash search tables 

hd(C) display files in hexadecimal 

hdestroy(S) hcreate(S) manage hash 

hdr(C) display selected parts of an 

head(C) print the first few lines of a 

header for a conmon object file 

header for common object files 

header for implementation-specific 

header for symbolic constants 

header of a COFF file 



header of a COFF file Idshread(S) 
header of a common object 



header of a member of an archive file 
help facility 



help(C) system help facility 

hexadecimal format 

hone directories 



hplp(C) hplpR(C) filter files for 



graph (C) 

graph (C) 

plot(S) 

grep(C) 

getpid(S) 

getgrent(S) 

getgrent(S) 

group (M) 

id(C) 

chown(C) 

setpgrp(S) 

getuld(S) 

getuld(S) 

getuld(S) 

setuld(S) 

newgrp(C) 

chown(S) 

kill(S) 

setpgrp(C) 

group (H) 

copy(C) 

make(C) 

tra(C) 

pwck(H) 

ssignal(S) 

haltsys(C) 

haltsys(C) 

varargs(F) 

curses (S) 

nohup(C) 
. add.hd(C) 

restore. hd(C) 
. layout (M) 

dump.hd(C) 

upgrade. hd(C) 
. spell (C) 
. spell(C) 

hsearch(S) 
. crypt (S) 

hsearch(S) 
. hd(C) 
_ haearch(S) 
. hdr(C) 
_ head(C) 

scnhdr(F) 
_ filehdr(F) 
. limits (F) 
_ unistd(F) 
. Idfhread(S) 

Idshread(S) 

Idohseek(S) 
, Idahread(S) 

help(C) 
_ help(C) 
. hd(C) 

fleece(C) 
. hplp(C) 
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LaserJet printer hplp(C) 
hash search tables 
sinh(S) cosh(S) tanh(S) 

id(C) print user and group 
chown(C) chgrp(C) change owner or group 
queue , semphore set , shared memory 
setpgrp(S) set process group 
whoami(C) print effective current user 

fstyp(M) determine the file system 
shmget(S) get shared memory segment 
reside devnm(C) 
what(C) 
structure fuser(M) 
process group, and parent process 
get real/effective user or group 
get real/effective user or group 
get real/effective user or group 
setuid{S) set user and group 
fpgetround(S) fpgetmask(S) 
fpgetround(S) fpgetsticky (S) 
fpgetround(S) fpsetmask(S) 
fpgetround(S) fpsetround(S) 
fpgetround(S) fpsetstioky (S) 
, core<F) format of core 
mem(M) kmem(M) memory 
scr_dump(F) format of curses screen 
nohup(C) run a command 
limits (F) file header for 
finc(M) fast 
dirent(F) file system 
file Idtbindex(S) compute the 
file Idtbread(S) read an 
file Idshread(S) read an 
descriptions 
fainfo(M) report 
finger (C) find 
devinto(C) display device 
default (M) default program 
reloc(F) relocation of 
Ipstat(C) print LP status 
statf3(S) f3tatfs(S) get file system 
sysconf (C) get system configuration 
sysconf(S) get systeai configuration 
syafs(S) get file system type 
uname(C) print the current UNIX 
drive (C) drive 
executes init 
clean the tile system and executes 
inittab(M) script for the 
special login program invoked by 
inlt(H) process control 
brc(M) system 
popen(S) pcl08e(S) 



hplpR(C) filter tiles for printing on 

hsearch(S) hde8troy(S) hcreate(S) manage 
hyperbolic functions 



hypot(S) Euclidean distance function 
ID and names 



id ipcrm(C) remove message 



id 

id(C) print user and group ID and names 

identifier 

identifier 

identify device name on which tiles 

identity files 



identify processes using a file or file 

IDs getpid(S) get process. 

IDs getuid(S) getegid(S) 

IDs getuid(S) geteuld(S) 

IDs getuid(S) getgid(S) 

IDs 

IEEE floating point environment control 
IEEE floating point environment control 
IEEE floating point environment control 
IEEE floating point environment control 
IEEE floating point environment control 

Image file 

image file 

image tile 

Immune to hangups and quits 

implementation-specific constants 

Incremental backup 



independent directory entry 

index of a symbol table entry of a COFF 

indexed symbol table entry of a COFF 

indexed/named section header of a COFF 

Intocmp(M) compare or print tennlnfo 

information about a tile system 

infomatlon about users 

Intormatlon 



information directory 

information for a common object file 
information 



information 

information 

information 

information 

information 

information written during manufacturing 

Inlr(H) clean the file system and 

Inlt Inir(M) 



Inlt processes 

init sulogin(H) 

initialization 

initialization procedure 

Initiate pipe to/from a process 

init(M) process control initialization _ 
Inlttab(H) script for the inlt processes 



hplp(C) 

hsearch(S) 

sinh(S) 

hypot(S) 

id(C) 

chown(C) 

ipcrm(C) 

setpgrp ( S ) 

whoami(C) 

id(C) 

tstyp(M) 

shmget ( S ) 

devnm(C) 

what(C) 

fuser(M) 

getpld(S) 

getuid(S) 

getuid(S) 

getuid(S) 

setuid(S) 

tpgetround(S) 

fpgetround(S) 

tpgetround(S) 

tpget round (S) 

fpgetround(S) 

core(F) 

mem(M) 

scr_dump(F) 

nohup(C) 

limlts(F) 

tlnc(H) 

dlrent(F) 

Idtbindex(S) 

Idtbread(S) 

Idshread(S) 

inf ocmp(M) 

t8info(M) 

finger (C) 

devinfo(C) 

default (M) 

reloc(F) 

Ipstat(C) 

statfs(S) 

sysconf (C) 

sysconf (S) 

8ysts(S) 

uname(C) 

drive (C) 

inlr(M) 

Inir(M) 

inlttab(M) 

sulogln(M) 

Init(M) 

brc(M) 

popen(S) 

inlt(M) 

Inittab(M) 
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clri(M) clear 
Inode(N) format of an 
ncheck(M) generate path names from 

report number of free disk blocks and 
gets(C) get a string from the standard 
line(C) read one line of 
fscanf(S) ascanf(S) convert formatted 
ungetc(S) push character back into 
fwrite(S) freadCS) binary 
poll(S) STREAMS 
stdio(S) standard buffered 
ciearerr(S) feof (S) stream status 
uustat(C) UUCP status 
install(M) 
cpset (C) 
options (H) floppy disk 

abs(S) return 
a641(S) ie4a(S) convert between long 
sputl(S) sgetKS) access long 
atoKS) atoi(S) convert string to 
13tol(S) ltol3(S) convert between 3-byte 
convert between 3-byte integers and long 
plot(S) graphics 
termio(M) general terminal 
log(M) 
spline(C) 
characters asa(C) 
sh(C) rsh(C) invoke the shell conmand 
csh(C) shell conmand 
pipe(S) create an 
status ipcs(C) report 
stdipc(S) ftok(S) standard 
nap(S) suspend execution for a short 
sleep (C) suspend execution for an 
sleep(S) suspend execution for 

commands 
intro(C) 
files intro(M) 
intro(CP) 
libraries intro(S) 
intro(F) 

features and files 
functions, and libraries 

yacc(CP) 
m4(CP) 
calendar(C) 
vi(C) 
ex(C) 
bsh(C) 
cc(CP) 
ed(C) red(C) 
edit(C) 
Id(CP) 



inode 

inode ^ 

inode numbers 

inode (M) format of an inode 

inodes df(M) 

input 

input ^ 



input scanf(S) 
input stream _ 
input /output _ 



input/output multiplexing 

input /output package 

Inquiries ferror(S) fileno 

inquiry and job control 

install commands 

install utilities 

installation menu 



install (M) install commands 

integer absolute value 

integer and base-64 ASCII st 
integer data 



integer strtoKS) 

integers and long integers 
integers 13tol(S) ltol3(S) 

interface subroutines 

interface 



interface to STREAMS error logging 

interpolate smooth curves 

interpret asa carriage control 

interpreter 



interpreter with C-like syntax 
interprocess channel 



inter-process communication facilities 

interprocess communication package 

interval 

interval 

interval 

intro(C) introduce commands 

intro(CP) introduce software development 
introduce coonands 



clri(M) 
inode (H) 
ncheck(M) 
inode (M) 
df (M) 
gets(C) 
line(C) 
scanf (S) 
ungetc(S) 
fwrite(S) 
poll(S) 
atdio(S) 
f error (S) 
uustat(C) 
install(M) 
cpset (C) 
options (M) 
install (M) 
abs(S) 
a641(S) 
sputl(S) 
StrtoKS) 
13tol(S) 
13tol(S) 
plot(S) 
termio(M) 
. log(M) 
spline(C) 
asa(C) 
. sh(C) 

csh(C) 
_ pipe(S) 
ipca(C) 
stdipc(S) 
nap(S) 
sleep (C) 
sleep(S) 
intro(C) 
intro(CP; 
intro(C) 
intro(M) 



introduce miscellaneous features and 
introduce software development commands _ intro(CP) 

Introduce system calls, functions, and intro(S) 

introduction to file formats intro(F) 

intro(F) introduction to file formats intro(F) 



intro(H) introduce miscellaneous 
intro(S) introduce system calls. 

invoke a compiler-compiler 

invoke a macro processor 

invoke a reminder service 



invoke a screen-oriented display editor 

invoke a text editor 

invoke the Business shell 

invoke the C compiler 



invoke the ed text editor 

invoke the edit text editor 
Invoke the link editor 



intro(M) 

intro(S) 

yacc(CP) 

m4(CP) 

calendar (C) 

vi{C) 

ex(C) 

bsh(C) 

cc(CP) 
. ed(C) 
_ edit(C) 

Id(CP) 
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xld(CP) 
masm(CP) 
sh(C) rsh(C) 
8ed(C) 
adb(C) 

sulogln(M) special login program 

abort (S) generate an 
set, shared memory id 
communication facilities status 
classify characters ctype(S) 
ctype(S) isdigit(S) ispunct(S) 
ttyname(S) 

ctype(S) i8alpha(S) islowerCS) 
classify characters ctype(S) 
characters ctype(S) isalpha(S) 
isnan(S) isnanf(S) 
point NaN isnan(S) 
floating point NaN 
characters ctype(S) isdigit(S) 
system(S) 
besseKS) 

uustat(C) UUCP status inquiry and 
join(C) 

numbers drand48(S) seed48(S) srand4e(S) 
Idunix(n) configurable 
mkunix(M) make bootable system file with 
makekey(M) generate an encryption 
killall(C) 



group of processes 
roem(M) 

integers and long integers 
base-64 ASCII string a641(S) 
labelit(M) copy file system with 
systems 
checking volcopy(M) 
labelit(C) provide 
awk(C) pattern scanning and processing 
bc(C) arbitrary-precision arithmetic 
nawk(C) pattern scanning and processing 
cpp(CP) the C 
lint (CP) check C 
bdiff(C) compare files too 
banner (C) print 
hplpR(C) filter files for printing on 

at(C) batch(C) execute cominands at a 

IdclOBe(S) 
member of an archive file 
reading Idopen(S) 



floating-point numbers frexp(S) roodf(S) 



invoke the link editor 

invoke the macro assembler 

Invoke the shell comnand interpreter 
invoke the stream editor 



invoke x . out general purpose debugger 
invoked by init 



ioctl(S) control device 
lOT fault 



ipcrm(C) remove message queue, sem 

ipcs(C) report inter-process 

isalpha(S) islower(S) iscntrl(S) 

isascii(S) classify characters 

isatty(S) find name of a terminal 

Iscntrl(S) classify characters 

isdlgit(S) i8punct(S) isascii(S) 
islower(S) iscntrl(S) classify 



isnand(S) test for floating point NaN 
isnanf(S) isnand(S) test tor floating 
isnan(S) lananf(S) isnand(S) test for 

ispunct(S) Isascil(S) classify 

issue a shell coimnand 

jO(S) yO(S) Bessel functions 

job control 



join two relations 

join(C) join two relations 

Jrand48(S) generate pseudo-random 
kernel linker 



kernel symbol table 
key 



kill all active processes 

klllall(C) kill all active processes 

kilKC) terminate a process 

kill(S) send a signal to a 
kmem(M) memory image file 



process or a 



13tol(S) ltol3(S) convert between 3-byte 
164a(S) convert between long integer and 
label checking volcopy(H) 



labellt(C) provide labels for file 

labellt(M) copy file system with label 

labels for file systems 

language 

language 

language 

Language Preprocessor 

language usage and syntax 

large for diff 

large letters 



LaserJet printer hplp(C) 

last(C) print last record of user logins 

later time 

layout (M) manage hard disk partitions 

Idaclose(S) close a COFF file 



Idahread(S) read the archive header of a 
Idaopen(S) open a common object file for 
Idclose(S) ldaclo»e(S) close a COFF file 

Id(CP) invoke the link editor 

Idexp(S) manipulate parts of 



xld(CP) 

masm(CF) 

sh(C) 

sed(C) 

adb(C) 

sulogin(M) 

ioctl(S) 

abort (S) 

ipcrm(C) 

ipcs(C) 

ctype(S) 

ctype(S) 

ttyname(S) 

ctype(S) 

ctype(S) 

ctype(S) 

isnan ( S ) 

Isnan(S) 

isnan(S) 

ctype(S) 

system(S) 

bessel (S) 
uustat(C) 
join(C) 
join(C) 
drand48(S) 
Idunix(M) 
mkunix(M) 
makekey(M) 
, killall(C) 
_ killall(C) 
kilKC) 
kill(S) 
mem(M) 
latoKS) 
a641(S) 
volcopy(M) 
labelit(C) 
volcopy(M) 
labelit(C) 
. awk(C) 
. bc(C) 

nawk(C) 
_ cpp(CP) 

lint (CP) 
_ bdiff (C) 

banner (C) 
. hplp(C) 
last(C) 
. at(C) 
layout (M) 
Idclose(S) 
Idahread(S) 
Idopen(S) 
Idclose(S) 
. Id(CP) 
frexp(S) 
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routines 

COFF file 
COFF symbol table entry 
entries of a COFF function Idlread(S) 
number entries of a COFF function 
of a section of a COFF file 
header of a coinnon object 
object file for reading 
a section of a COFF file 
section header of a COFF file 
symbol table entry of a COFF file 
entry of a COFF file 
a COFF file 

leave (C) remind you when you have to 
leave 

getopt(S) get option 
banner (C) print large 
analysis 

lex (CP) generate programs for 
Isearch(S) 
ar(CP) maintain archives and 
chkshlib(CP) tool for comparing shared 
introduce system calls, functions, and 
ranlib(CP) convert archives to random 
xar(CP) maintain archives and 
find ordering relation for object 
mkshlib(CP) create a shared 
shuttype(S) get and set UPS shutdown 
ulimit(S) get and set user 
implementation-specific constants 
dial(S) establish an out-going terminal 
set terminal type, modes, speed. 

file llnenum(F) 
Idlread(S) Idlitea(S) manipulate 
COFF file Idlseek(S) seek to 
strip(CP) remove symbols and 
nl(C) add 
line(C) read one 
Ipd(M) 

cancel (C) send/cancel requests to LP 
turn on/off 
Ipdisable(C) enable/disable If 
Ipinit(M) add new 
laearch(S) Ifind(S) 

ccasson object file 
coni(C) select/reject 
fold(C) told long 
unig(C) report repeated 
look(C) find 
num(C) number 
rev(C) reverse 
head(C) print the first few 
ssp(C) remove consecutive blank 
wc(C) count 
link(M) unlink(M) 



Idfcn(P) cooBion object file access 

Idfhread(S) read the file header of a _ 
Idgetname(S) retrieve symbol name for 

Idliten(S) manipulate line number 

Idlread(S) Idlitem(S) manipulate line 
Idlseek(S) seek to line number entries 
Idohseek(S) seek to the optional file 
Idopen(S) Idaopen(S) open a cornnon 



Idrseek(S) seek to relocation entries of 
Idshread(S) read an indexed/named 



Idtbindex(S) compute the index of a 

Idtbread(S) read an indexed symbol table 
Idtbseek(S) seek to the symbol table of 

Idunix(M) configurable kernel linker 

leave 

leave(C) remind you when you have to 

letter from argument vector 

letters 

lex(CF) generate programs for lexical 

lexical analysis 



Ifind(S) linear search and update 

libraries 

libraries 



libraries intro(S) 

libraries 

libraries 



library lorder(CP) 

library 

limits 

limits 



limits (F) file header for 
line connection 



line discipline uugetty(M) 

line number entries in a common object 
line number entries of a COFF function 
line number entries of a section of a _ 

line numbers from COFF file 

line numbers to a file 

line of input 



line printer daemon 

line printer lp(C) 

line printer scheduler 

line printers Ipenable(C) 
line printers 



linear search and update 

line(C) read one line of input 

linenum(F) line number entries in a 

lines connon to two sorted files 

lines for finite width output device 

lines in a file 

lines in a sorted list 

lines 

lines of a file 

lines of a stream 

lines 

lines, words, and characters 

link and unlink files and directories 



Idfcn(F) 

Idfhread(S) 

Idgetname(S) 

Idlread(S) 

Idlread(S) 

Idlseek(S) 

Idohseek(S) 

Idopen ( S ) 

Idrseek(S) 

Idshread(S) 

Idtbindex(S) 

Idtbread(S) 

Idtbseek(S) 

Idunix(H) 

leave (C) 

leave ('O 

getopt(S) 

banner (C) 

lex (CP) 

lex(CP) 

Isearch(S) 

ar(CP) 

chkshlib(CP) 

intro(S) 

ranlib(CP) 

xar(CP) 

lorder(CP) 

mkshllb(CP) 

shuttype ( S ) 

ulimit(S) 

limits (F) 

dial(S) 

uugetty(M) 

linenum(F) 

Idlread(S) 

Idlseek(S) 

strip(CP) 

, nl{C) 
line(C) 
Ipd(H) 

. lp(C) 
Ipon(M) 
Ipenable(C) 
Ipinit(M) 
Isearch(S) 
Xine(C) 
linenum(F) 
conni(C) 
fold(C) 
uniq(C) 
look(C) 
num(C) 

. rev(C) 
head(C) 
S8p(C) 

. wc{C) 
link(M) 



PI-28 



Permuted Index 



Id(CF) Invoke the 
a.out{F) format of assembler and 
xld(CP) Invoke the 
llnk(S) 
ln(C) make a 
Idunlx(M) conflourable kernel 
and directories 

syntax 
18(C) 

xliat(S) fxlist(S) get name 
checklist (M) 
look(C) find lines in a sorted 
nlist(S) get entries from name 
nm(CP) print name 
terminals (M) 

varargs(F) handles variable argtiment 
print formatted output of varargs 
from(C) 
xnm(CP) print name 
COFF file 

cref(CP) make a cross-reference 
list (CP) produce C source 

string ctlme(S) gmtime(S) 
program wherels(C) 
end(S) edata(S) etext(S) last 
lock(S) 
plock(S) 

lockf(S) record 
read/write 

locking(S) 
errprint(M) display error 
gafflma(S) 

set maximum number of users allowed to 
newgrp(C) 

exp(S) poH(S) log(S) exponential. 
exp(S) sqrt(S) exponential. 
strclean(M) STBEAMS error 
8trerr(M) STREAMS error 
log(M) interface to STREAMS error 
sizefa(C) determine the size of a 
get login (S) get 
logname(C) get 
cuserld(S) get character 
logname { S ) return 
passwd(C) change 
sulogln(H) special 
ttys(M) 

profile(M) set up environment at 

last(C) print last record of user 
disable (C) disable 
enable(C) enable 
logging 



link editor 

link editor output 

link editor 

link to a file 

link to a tile 

linker 

link(M) unllnk(M) link and unlink files 

link(S) link to a file 

lint(CP) check C language usage and 

list contents of directories 

list entries from files 



list file systems processed by fsck 

list 

list 

list of common object file 

list of supported terminals 

list 

list vprintf(S) vfprintf(S) vsprintf(S) 

list who my mail is from 

list 

list (CP) produce C source listing from 

listing 

listing from COFF file 

ln(C) make a link to a file 



localtime(S) convert date and time to 
locate source, binary, or manual for _ 
locations in program 



lock a process in primary memory 

lock process, text, or data in memory 

lockf (S) record locking on files 

locking on files ______________ 



locking(S) lock/unlock a file region for 
lock(S) lock a process in primary memory 
lock/unlock a file region for read/write 

log contents 

log gamaa function 



log in numusers(S) get and 

log user into a now group 

logarithm, and power functions 

logarithm, and square root functions 

logger cleanup program 

logger daemon 

logging 

logical disk drive 

login name 

login name 



login name of the user 

login name of user 

login password 



login program invoked by init 

login terminals file 

login time 



login(C) give you syste 
logins 



logins on a port 

logins on a port 

log(H) interface to STREAMS error 



Id(CP) 

a.out(F) 

xld(CP) 

link(S) 

ln(C) 

Idunix(M) 

link(M) 

link(S) 

lint(CP) 

ls(C) 

xlist(S) 

checklist (M) 

look(C) 

nlist(S) 

nm(CP) 

terminals (M) 
varargs (F) 
vprintf (S) 
from(C) 
xnm(CP) 
list (CP) 
cref (CP) 
list (CP) 

. ln(C) 
ctime(S) 
whereis(C) 

. end(S) 
lock(S) 
plock(S) 
lockf (S) 
lockf (S) 
locklng(S) 
lock(S) 
locking(S) 
errprint (M) 
gan»a(S) 
numusers(S) 
newgrp(C) 
exp(S) 
exp(S) 
strclean(M) 
strerr(M) 
log(M) 
sizef8(C) 
getlogin(S) 
logname(C) 
cuserld(S) 
logname(S) 
passwd(C) 
sulogin(M) 

_ ttys(M) 

_ profile(M) 
login (C) 

_ last(C) 
disable (C) 
enable (C) 

_ log(M) 
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functions exp(S) pow(S) 
set jmp(S) 
fleece(C) 

object library 
lp(C) cancel(C) send/cancel requests to 
Ipenable(C) IpdlsableCC) enable/disable 
Ipsched(M) Ipshut(M) start/stop the 
Ipsched(N) Ipiiiove(M) move 
Ipadinin(M) configure the 
Ipstat(C) print 
system 
LP line printer 
printers Ipenable(C) 

LP line printers 

Ipsched(H) 
turn on/off 
spooler 

request scheduler 
scheduler Ipsched(M) 

drand48(S) mrand48(S) nrand48(S) 



and long integers 13tol(S) 
values (F) 

aftp(C) transfer tiles between Altos 
masm(CP) invoke the 
m4(CP) invoke a 
enroll (C) xsend(C) xget(C) secret 
mall(C) system 
aliases (M) 

aliashash(M) rebuild data base tor 

troiii(C) list who ny 
malloc(S) 

malloc(S) tree(S) realloc(S) fast 
mallinfo(S) mallopt(S) calloc(S) fast 
ar(CP) 
xar(CP) 
of programs make(C) 
groups of programs 



main memory allocator malloc(S) 
memory allocator 



calloc(S) fast main memory allocator 
allocator malloc(S) mallinfo(S) 



logname(C) get login name 

logname(S) return login name of user 

log(S) exponential, logarithm, and power 
longjmp(S) non-local goto 



look for files in home directories 

look(C) find lines in a sorted list 

lorder(CP) find ordering relation for 

LP line printer 

LP line printers 

LP request scheduler 

LP requests 



LP spooling system 

LP status information 

Ipadmin(n) configure the LP spooling 

lp(C) cancel (C) send/cancel requests to 

Ipdisable(C) enable/disable LP line 

Ipd(M) line printer daemon 



Ipenable(C) Ipdisable(C) enable/disable 

Ipinit(M) add new line printers 

Ipmove(H) move LP requests 

Ipon(M) line printer scheduler 



Ipr(C) route named files to printer _ 
Ipsched(H) Ipmove(H) move LP requests 
Ipsched(H) Ipshut(M) start/stop the LP Ipsched(M) 



logname ( C ) 
logname ( S ) 
exp(S) 
set jmp(S) 
tleece(C) 
look(C) 
lorder(CP) 
lp(C) 

Ipenable(C) 

Ipsched(M) 

Ipsched(M) 

Ipadmln(M) 

Ipstat(C) 

Ipadinln(M) 

lp(C) 

Ipenable(C) 
Ipd(M) 
Ipenable(C) 
Ipinit(M) 
Ipsched(M) 
Ipon(M) 
Ipr(C) 
Ipsched(H) 



Ipshut(M) start/stop the LP request 

Ipstat(C) print LP status information 

lrand48(S) generate pseudo-random/ 

ls(C) list contents of directories 



Isearch(S) Itind(S) linear search and 

l8eek(S) move read/write file pointer 

ltol3(S) convert between 3-byte integers 

m4(CP) invoke a macro processor 

machine-dependent values 

machines 

macro assembler 

macro processor 

mail 

mail 

mail alias file 

mail alias file 

mall(C) system mail 

mail is from 



Ipsched(M) 
Ipstat(C) 
drand48(S) 
ls(C) 

Isearch(S) 
Iseek(S) 
13tol(S) 
m4(CP) 
values (F) 
attp(C) 
masm(CP) 
m4(CP) 
enroll (C) 
malKC) 
aliases (M) 
aliashash(M) 
mail(C) 
trom(C) 
malloc(S) 
malloc(S) 
malloc(S) 
ar(CP) 
xar(CP) 
make(C) 
make(C) 



main memory allocator 

main memory allocator 

main memory allocator malloc(S) 

maintain archives and libraries 

maintain archives and libraries 

maintain, update, and regenerate groups 
make(C) maintain, update, and regenerate 
makedevs(M) create special device files _ makedevs(M) 

makekey(M) generate an encryption key makekey(M) 

makettys(M) create tty special tiles makettys(H) 

mallinfo(S) mallopt(S) calloc(S) fast maHoc(S) 

malloc(S) free(S) realloc(S) fast main malloc(S) 

malloc(S) main memory allocator malloc(S) 

malloc(S) mallinfo(S) mallopt(S) malloc(S) 

mallopt(S) calloc(S) fast main memory malloc(S) 
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tsearch(S) tfind(S) tdelete(S) twaik(S) 
layout (M) 

hsearch(S) hdestroy(S) hcreate(S) 
crontab(C) 

sigrelse(S) slglgnore(S) signal 
sigset(S) slgpause(S) signal 
function Idlread(S) Idlitein(S) 
numbers frexp(S) modf(S) Idexp(S) 
section mcs(CP) 
whereis(C) locate source, binary, or 
aysaltos(S) 

drive information written during 
add new bad sectors to the bad sector 
ascii(M) 

umask(C) set file-creation mode 
umask(S) set and get file creation 

master(M) 

regexp(F) regular expression compile and 
regexp(S) compile regular expression and 
math(F) 



in numuaers(S) get and set 
comment section 
Idahread(S) read the archive header of a 
memory ( S ) 

memory (S) memset(S) memcpy(S) memcmp(S) 
memorv(S) mensetCS) memcpy(S) 
operations memory (S) memset(S) 

malloc(S) free(S) realloc(S) fast main 
malloc(S) main 
mallopt(S) calloc(S) fast main 
shmctl(S) shared 
message queue, semphore set. shared 
mem(H) kmem(M) 
lock(S) lock a process in primary 
memory ( S ) memccpy ( S ) 
memset(S) memcpy(S) memcmp(S) meiiichr(S) 
shmop(S) shared 
plock(S) lock process, text, or data in 
sh«get(S) get shared 

meiachr(S) aaanry operations 
memory operations memory (S) 
options (M) floppy disk installation 
menus (M) format of Business Shell 
digest (C) create 
system 
sort(C) sort and 
to a terminal 
msgctl(S) 
mkstr(C) create an error 
mkstr(CP) create an error 
getmsg(S) get next 



manage binary search trees 

manage hard disk partitions 

manage hash search tables 

manage user crontab files 

management slgset(S) sighold(S) 
management 



manipulate line number entries of a COFF 

manipulate parts of floating-point 

manipulate the object file comment 

manual for program 



manufacturer specific system requests 

manufacturing drive(C) 

map badblock(C) 



map of the ASCII character set 

mask 

mask 



masm(CF) invoke the macro assembler 
master configuration database 



master(M) master configuration database 

match routines 

match routines 



math functions and constants 

matherr(S) error-handling function 

math(F) math functions and constants 

maximum number of users allowed to log 

mcs(CP) manipulate the object file 

member of an archive file 

memccpy(S) memory operations 

menchr(S) memory operations 



tsearch(S) 

layout (M) 

hsearch (S ) 

crontab (C) 

sigset (S) 

sigset (S) 

Idlread(S) 

frexp(S) 

mcs(CP) 

whereis (C) 

sysaltos(S) 

drive(C) 

badblock(C) 

aacii(M) 

umask(C) 

umask ( S ) 

masm(CP) 

master (M) 

master (M) 

regexp(F) 

regexp(S) 

math(F) 

matherr(S ) 

math(F) 

numusers(S) 

mcs(CP) 

Idahread(S) 

memory (S) 

memory (S) 



mencmp(S) memchr(S) memory operations mefflory(S) 

mencpy(S) memcinp(S) memchr(S) memory memory(S) 

mem(M) kmem(M) memory image file meffl(H) 

meoory allocator malloc(S) 

memory allocator malloc(S) 

_ malloc(S) 
_ shmctl(S) 
_ ipcrm(C) 
_ mem(M) 
_ lock(S) 
_ memory (S) 
_ memory (S) 
_ shmop(S) 
_ plock(S) 
_ shmget(S) 
_ memory (S) 
_ memory (S) 
_ memory(S) 
_ options (M) 
_ menus (M) 
_ digest (C) 
_ menus (M) 
_ sort(C) 

mesg(C) allow or disallow messages sent _ mesgtC) 

message control operations msgctl(S) 

message file from C source mkstr(C) 

mkstr(CP) 
getmsg(S) 



memory allocator malloc(S) mallinfoCS) 

memory control operations 

memory id ipcrm(C) remove 

memory image file 

memory 

memory operations 

memory operations memory(S) ________ 

memory operations 

memory 

memory segment identifier 

memorY(S) memccpy(S) memory operations 
meffiory(S) memset(S) memcpy(S) memcmp(S) 
memset(S) memcpy(S) memcmp(S) memchr(S) 

menu 

menu system 

menu system(s) for the Business Shell _ 
menus (M) format of Business Shell menu 
merge files 



message file from C source 
message off a stream 
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putinag(S) send a 
msgop ( S ) 
msgget(S) get 
memory Id Ipcnn(C) remove 
perror(S) system error 
mesg(C) allow or disallow 
strace(M) print STKEAHS trace 
3y3_errlist (S) errno(S) system error 
clone (M) open any 
Intro (M) introduce 
bootable object file 



or ordinary file 



from C source 
from C source 



driver symbol table 
kernel symbol table 



getty(M) set terminal 
umask(C) set file-creation 
bring system up multi /single-user 
cbmod(S) change 
setmodem(C) set up tty port for a 
uugetty(M) set terminal type. 

tset(C) set terminal 
setmode(C) printer 
floating-point numbers frexp(S) 
settlme(C) change the access and 
touch (C) update access and 
utime(S) set file access and 

time 
mount (S) 
multiple tile systems 
structure 
mnttab(H) 

mount (C) unount(C) 
mountall(C) unountalKC) 
Ipscbed(M) Ipinove(H) 
l8eek(S) 
mv(C) 

generate pseudo-random/ drand48(S) 
dos(C) access 



mountall(C) umountall(C) mount/unmount 
poll(S) STREAMS input /output 
singleuser(C) bring system up 
rc2(H) comnands for 



message on a stream 

message operations 

message queue 

message queue, semphore set, shared 
messages 



messages sent to a terminal 
messages 



messages sys_nerr(S) 

minor device on STREAMS driver 

miscellaneous features and files 
mkboot(M) convert object file to 

mkdir(C) make a directory 

mkdir(S) make a directory 



mkfs(M) construct a file system 
mknod(C) build special files 



mknod(S) make a directory, or a special 

mkshlib(CP) create a shared library 

mkstr(C) create an error message file _ 
mkstr(CF) create an error message file mkstr(CP) 



putmsg ( S ) 
msgop ( S ) 
msgget (S) 
ipcrm(C) 
perror (S) 
mesg(C) 
strace(M) 
sys_nerr (S) 
clone (M) 
intro(«) 
mkboot (M) 
mkdlr(C) 
mkdlr(S) 
mkfs(M) 
mknod(C) 
mknod(S) 
mkshlib(CF) 
mkstr(C) 



mktemp(S) make a unique file name 

mkunix(M) make bootable system file with 
mkunix(M) make bootable system file with 

mkvers(CP) generate a what string 

mnttab(M) mounted file system table 

mode 

mode mask 

mode multiuser(C) singleuser (C) 

mode of file 

modem 



modes, speed, 
modes 



line discipline 



modes utility 

modf(S) Idexp(S) manipulate parts 

modification dates of files 

modification times of a file 

modification times 



monitor (S) prepare execution profile 

more(C) view a file one full screen at 
mount a file system 



mountall(C) unountall(C) mount/unmount _ 
mount (C) umount(C) mount/unmount a file 

mounted file system table 

mount (S) mount a file system 

mount/unmount a file structure 

mount /unmount multiple file systems 

move LP requests 



move read/write file pointer 

move (rename) files and directories 

mrand48(S) nrand48(S) lrand48(S) 

MS-DOS files 



msgctl(S) message control operations 

msgget (S) get message queue 

msgop (S) message operations 

multiple file systems 

multiplexing 



multl/single-user mode multluser(C) 
multi-user environment 



mktemp(S) 

mkunix(M) 

mkunix(M) 

mkvers(CP) 

mnttab(M) 

getty(M) 

umask(C) 

multiuser (C) 

chmod(S) 

setmodem(C) 

uugetty(M) 

taet(C) 

setmode(C) 

frexp(S) 

settime(C) 

touch(C) 

utime(S) 

monitor (S) 

more(C) 

mount (S) 

mountall(C) 

mount (C) 

mnttab(H) 

mount (S) 

mount (C) 

mountall(C) 
. Ipsched(H) 

Iseek(S) 
. mv(C) 
. drand48(S) 
. dos(C) 

msgctl(S) 

msgget (S) 

msgop (S) 
mountall(C) 
_ polKS) 
multiuser (C) 
rc2(M) 
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up nultl/ainole-u«er mode 
directories 
tinpnara(S) tenpnanCS) create a 
Idgetnaiiie(S) retrieve symbol 
ctermid(S) generate file 
getpw ( S ) get 

getenv(S) return value for environment 
getlogin(S) get login 
xliat(S) fxlist(S) get 
nlist(S) get entries from 
nin(CP) print 
xnm(CP) print 
logname(C) get login 
mktemp(S) make a unique file 
ttyname(S) isatty(S) find 
uname(S) get 
getcHd(S) get path 
cuseridCS) get character login 
logname(S) return login 
devnm(C) identify device 
pHd(C) print working directory 
tty(C) get the current port 
Ipr(C) route 
terin(M) conventional 
ncheck(H) generate path 
id(C) print user and group ID and 
isnand(S) test for floating point 
interval 
language 

semaphore resource Haitsefli(S) 
numbers 

getmsg(S) get 

dbffl(S) dbminit(S) fetch(S) 
priority 



file 
and quits 
setjmp(S) longjmp(S) 
false(C) return with a 
pseudo-random/ drand48(S) mrand48(S) 
null(H) 

linenun(P) line 
Idlread(S) ldlite«(S) manipulate line 
file Idlseek(S) seek to line 
factor(C) factor a 
nuB(C) 
df(M) report 
numusers(S) get and set maximum 
random (C) generate a random 
convert string to double-precision 
ecvt(S) convert floating-point 
erand48(S) generate pseudo-random 
lrand48(S) generate pseudo-random 



multiuser(C) aingleuser (C) bring syste 

mv(C) move (rename) files and 

name for a temporary file 



name for COFF symbol table entry 

name for terminal 

name from UID 

name 

name 

name list entries from files 

ncune list 



name list of common object file 
name list 



name 

name 

name of a terminal 

name of current UNIX system 

name of current tiorking directory 

name of the user 

name of user 



which files reside 



name 

name 

named files to printer spooler 

names for terminals 

names from inode numbers 

names 



NaN isnan(S) isnanf(S) 

nap(S) suspend execution for a short 

nawkCC) pattern scanning and processing 

nbHaitsem(S) wait and check access to 

ncheck(H) generate path names from inode 

newgrp(C) log user into a new group 

next message off a stream 



nextkey(S) perform database functions 
nice(C) run a coonand at a different 
nice(S) change priority of a process 
nl(C) add line numbers to a file 



nlist(S) get entries from name list 

nn(CP) print name list of cosnon object 
nohup(C) run a command immune to hangups 

non-local goto 

nonzero exit value 



nrand48(S) lrand48(S) generate 
null file 



null(M) null file 

number entries in a common object file 

number entries of a COFF function 

number entries of a section of a COFF 
number 



number lines 

number of free disk blocks and inodes 

number of users allowed to log in 

number 

number strtod(S) atof(S) 

number to string 



numbers drand48(S) 

numbers /mrand48(S) nrand4S(S) 



multiuser(C) 

mv(C) 

tmpnsm ( S ) 

Idgetname(S) 

ctermid(S) 

getpw(S) 

getenv(S) 

getlogin(S) 

xlist(S) 

nlist(S) 

nm(CP) 

xnm(CP) 

logname(C) 

mktemp(S) 

ttyname(S) 

uname(S) 

getcwd(S) 

cuserid(S) 

logname{S) 

devnm ( C ) 

pwd(C) 

, tty(C) 

. Ipr(C) 
term(M) 
ncheck(H) 

, id{C) 
i8nan(S) 
nap(S) 
nawk(C) 
waitsem(S) 
ncheck(M) 
newgrp(C) 
getmsg(S) 
dbm(S) 
nice(C) 
nice(S) 

. nl(C) 
nliat(S) 
nm(CP) 
nohup(C) 
setjmp(S) 
false(C) 
drand48(S) 
null(M) 
null(M) 
llnenum(F) 
Idlread(S) 
Idlseek(S) 
factor(C) 
num(C) 
df(M) 

numusers(S) 

random (C) 

strtod(S) 

ecvt(S) 

drand48(S) 

drand48(S) 
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jrand48(S) generate pseudo- random 
manipulate parts of floating-point 
strip(CP) remove symbols and line 
ncheck(M) generate path names from inode 
nl(C) add line 

of users allowed to log In 
dis(CP) 
Idfcn(F) common 
incs(CF) manipulate the 
cprs(CF) compresse a common 
dump(CP) dump selected parts of an 
Idopen(S) Idaopen(S) open a common 
f ixobj (CP) convert an 
hdr(C) display selected parts of an 
line number entries in a common 
convert object file to bootable 
nm(CF) print name list of common 
relocation of information for a common 
scnhdr(F) section header for a common 
find the printable strings in an 
syms(F) common 
mkboot (M) convert 
conv(CF) convert common 
filehdr(F) file header for common 
size(C) print section sizes of common 
to the optional file header of a common 
lorder(CP) find ordering relation for 
od(C) display files in 

f ixobj (CP) convert an object file from 
Idopen(S) Idaopen(S) 
opensen(S) 
fopen(S) fdopen(S) f reopen (S) 
clone (M) 

dup(S) dup2(S) duplicate an 
open(S) 

directory(S) telldir(S) readdir(S) 



rcO(H) connandB to stop the 
rewinddir(S> Beekdir(S) directory 
readdir(S) opendir(S) directory 
megK>ry(S) ■MaK:cpy(S) memory 
memcpy(S) mencnpCS) ■leaichr(S) memory 
BsgctKS) message control 
■sgop(S) message 
semctKS) senaphore control 
seiBop(S) semaphore 
shmctl(S) shared memory control 
shmop(S) shared memory 
strdup(S) strpbrk(S) strcmp(S) string 
strcpy(S) strlen(S) strchr(S) string 
string(S) strspn(S) strtok(S) string 
curses (S) terminal screen handling and 
getopt(S) get 
Idohseek(S) seek to the 



numbers drand48(S) seed48(S) srand48(S) 

numbers frexp(S) modf(S) Idexp(S) 

numbers from COFF file 

numbers 

numbers to a file 

num(C) number lines 



numusers(S) get and set maximum number 

object code disassembler 

object file access routines 

object file comment section 

object file 

object file 



object file for reading 

object file from 0«F to COFF 
object file 



object file linenum(F) 
object file mkboot (H) 
object file 



object file reloc(F) 
object file 



object file strings (C) 

object file symbol table format 

object file to bootable object file 

object files 

object files 

object files 



object IdohBeek(S) seek 

object library 

octal format 



od(C) display files in octal format 
OMF to COFF 



open a common object file for reading 

open a semaphore 

open a stream 



open any minor device on STREAMS driver 
open file descriptor 



open for reading or writing 

opendir(S) directory operations 

open(S) open tor reading or writing 

open8en(S) open a semaphore 

operating system 



operations directory(S) closedir(S) 
operations directory(S) telldir(S) 
operations 



operations memory (S) memset(S) 

operations 

operations 

operations 

operations 

operations 

operations 



operations string(S) strcat(S) 
operations string(S) strncmp(S) 
operations 



optimization package 

option letter from argument vector 
optional file header of a comnon object _ Idohseek(S) 



drand48(S) 
frexp(S) 
strip (CP) 
ncheck(M) 
nl(C) 
num(C) 
numusers ( S ) 
dis(CP) 
Idfcn(F) 
mcs(CP) 
cprs(CP) 
dump (CP) 
Idopen(S) 
f ixobj (CP) 
hdr(C) 
linenum(F) 
mkboot (M) 
nm(CP) 
reloc (F) 
scnhdr(F) 
strings (C) 
syms(F) 
mkboot (M) 
conv(CP) 
filehdr(F) 
size(C) 
Idohseek(S) 
lorder(CP) 
. od(C) 
od(C) 

f ixobj (CP) 
Idopen(S) 
opensem(S) 
fopen(S) 
clone (M) 
. dup(S) 
open(S) 
directorY(S) 
open(S) 
opensem(S) 
. rcO(M) 
directory (S) 
directory (S) 
memory (S) 
memory(S) 
msgctl(S) 
msgop(S) 
semctl(S) 
semop(S) 
shmctl(S) 
shmop(S) 
string(S) 
string(S) 
string(S) 
curses (S) 
_ getopt(S) 
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fcntl(F) file control 
stty(C) set the 
xttY(C) set the 
getopt(C) parse command 
getoptB(C) parse command 

lorder(CP) find 
make a directory, or a special or 
diaX(S) establish an 
format of assembler and link editor 
fold(C) fold long lines for finite width 
vfprintf(S) vsprintf(S) print formatted 
pr(C) print files on the standard 
sprintf(S) fprintf(S) print formatted 
sysdef (M) 
chown(S) change 
chovm(C) chgrp(C) change 
quot(C) summarize file system 
screen handling and optimization 
sar(M) system activity report 
stdio(S) standard buffered input/output 
standard interprocess communication 
expand files 
tk(C) 

get process, process group, and 
getopt(C) 
getopts(C) 
tail(C) deliver the last 
layout (H) manage hard disk 
dump (CP) dump selected 
hdr(C) display selected 
frexp(S) modf(S) Idexp(S) manipulate 



crypt (S) 

fgetpwent(S) endpwent(S) setpwentCS) get 
getpwent(S) getpwnam(S) getpwuid(S) get 
putpwent(S) write 
passwd(H) 
getpasCS) read a 
passHd(C) change login 
pwck(H) grpck(M) check 
getcHd(S) get 
ncheck(H) generate 
dirnane(C) deliver portions of 
grep(C) search a file for a 
awk(C) 
nawk(C) 

egrep(C) search file for 

files pack(C) 
process popen(S) 

dbm(S) dbminit(S) fetch(S) nextkey(S) 
dbm(S) firstkey(S) store(S) fetch(S) 
check the uucp directories and 
chinod(C) change 



options 

options for a port 
options for a port 

options 

options 



options (M) floppy disk installation menu 

ordering relation for object library 

ordinary file mknod(S) 



out-going terminal line connection 

output a.out(F) 

output device 



output of varargs list vprlntf(S) 
output 



output printf(S) 

output system definition 
owner and group of a file 

owner or group ID 

ownership 



package curses (S) terminal 

package 

package 



package atdipc(S) ftok(S) 

pack(C) pcat(C) unpack (C) compress and 

paginator for Tektronix 4014 

parent process IDs getpid(S) 

parse command options 

parse command options 

part of a file 

partitions 



parts of an object file 

parts of an object file 

parts of floating-point numbers 
passwdCC) change login password 
passwd(M) password file 



password and file encryption functions 

password file entry getpwent(S) 

password file entry 

password file entry 

password file 

password 

password 



fcntl(F) 
stty(C) 
xtty(C) 
getopt(C) 
getopts (C) 
opt ions (M) 
lorder(CP) 
mknod ( S ) 
dial(S) 
a.out(F) 
fold(C) 
vprintf (S) 
pr(C) 
printf (S) 
sysdef (M) 
chown ( S ) 
chown(C) 
quot(C) 
curses ( S ) 
sar(M) 
stdio(S) 
stdipc(S) 
pack(C) 
tk(C> 
getpid(S) 
getopt(C) 
getopts (C) 
tail(C) 
layout (M) 
dump (CP) 
hdr(C) 
frexp(S) 
passwd(C) 
passwd(M) 
crypt(S) 
getpwent ( S ) 
getpwent ( S ) 
putpwent(S) 
passwd(M) 
getpas(S) 
passwd(C) 
pwck(M) 



password/group file 

path name of current working directory getcwd(S) 



path names from Inode numbers 

pathnames baaename(C) 

pattern 



pattern scanning and processing language 
pattern scanning and processing language 
pattern using full regular expression egrep(C) 



ncheck(M) 
basename ( C ) 
grep(C) 
awk(C) 
nawk(C) 



pause(S) suspend process until signal 
pcat(C) unpack(C) compress and expand 

pclose(S) initiate pipe to/from a 

pconfig(C) set port configuration 

perform database functions 

perform database functions 

permissions file uucheck(M) 



pemisslons of a file or directory 



pause (S) 

pack(C) 

popen(S) 

pconf ig(C) 

dbm(S) 

dbffl(S) 

uucheck(M) 

chmod(C) 
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acct(M) format of per-process accounting file 



split (C) split a file into 
tee(C) create a tee in a 
popen(S) pcloae(S) initiate 

memory 

fpgetround(S) fpgetmask(S) IEEE floating 
fpgetsticky(S) IEEE floating 
fpgetround(S) fp8etmask(S) IEEE floating 
fp8etround(S) IEEE floating 
fpsetsticky(S) IEEE floating 
isnanf(S) isnand(S) test for floating 
ftelKS) rewind(S) reposition a file 
Iseek(S) move read/write tile 
multiplexing 
a process 
pconfig(C) set 
disable(C) disable logins on a 
enable (C) enable logins on a 
8etmodem(C) set up tty 
tty(C) get the current 
stty(C) set the options for a 
xtty(C) set the options for a 
basename(C) dirname(C) deliver 
log(S) exponential, logarithm, and 
and power functions exp(S) 

dc(C) arbitrary 
monitor(S) 
cpp(CF) the C Language 
unget(CP) undo a 
lock(S) lock a process in 
types (F) 
caKC) 
yes(C) 
prs(CP) 
date(C) 
sact (CP) 
whoami(C) 
pr(C) 

vprintf(S) vtprintf(S) vsprintf(S) 
printf(S) aprintf(S) fprlntf(S) 
banner (C) 
last(C) 
Ipstat(C) 
ni»(CP) 
xnn(CF) 
printenv(C) 

accept (C) reject (C) allow/prevent 
pscreen(C) set up terminal to 
files size(C) 
printers (H) 
strace(H) 
Infocmp(M) compare or 



perror(S) system error messages 

pg(C) file perusal filter 

pieces - 

pipe 



pipe to/from a process 

pipe(S) create an interprocess channel 
plock(S) lock process, text, or data in 
plot(S) graphics Interface subroutines 
point environment control 



point environment control fpgetround(S) 
point environment control 



_ acct(M) 

perror(S) 

_ PS(C) 
_ split (C) 
_ tee(C) 
_ popen(S) 
_ pipe(S) 

plock(S) 
_ plot(S) 

fpgetround(S) 

_ fpgetround(S) 
fpgetround(S) 



point environment control fpgetround(S) _ f pgetround ( S ) 
point environment control fpgetround(S) _ fpgetround(S) 
point NaN isnan(S) 



pointer in a stream fseek(S) 
pointer 



poll(S) STREAMS input /output 

popen(S) pclose(S) initiate pipe to/from 

port configuration 

port 

port 



port for a modem 

port name 

port 

port 



portions of pathnames 

power functions exp(S) pow(S) 

pow(S) log(S) exponential, logarithm, 

pr(C) print files on the standard output 

precision calculator 

prepare execution profile 

Preprocessor 



previous get of an SCCS file 
primary memory 



primitive system data types 
print a calendar 



print a string repeatedly 

print an SCCS file 

print and set the date 



isnan ( S ) 
fseek(S) 
Iseek(S) 
poll(S) 
popen(S) 
pconflg(C) 
disable (C) 
enable (C) 
setmodem(C) 
, tty(C) 
stty(C) 
xtty(C) 
basenameCC) 
exp(S) 
, exp(S) 

pr(C) 
. dc(C) 
monitor(S) 
cpp(CP) 
unget(CP) 
lock(S) 
types(F) 
. cal(C) 
, ye8(C) 
. prs(CP) 
date(C) 



print current SCCS file edit activity sact (CP) 

print effective current user id whoaml(C) 

print files on the standard output pr(C) 

print formatted output of varargs list vprlntf (S) 

print formatted output printf(S) 

banner (C) 

last(C) 

Ipstat(C) 



print large letters 

print last record of user logins 

print LP status Information 

print name list of common object file nm(CP) 

print name list xnm(CP) 



print out the environment 

print requests 

print screen display 



print section sizes of common object 

print spooler configuration file 

print STREAMS trace messages 

print terminfo descriptions 



printenv(C) 

accept (C) 

pscreen(C) 

size(C) 

printers (M) 

strace(M) 

infocmp(M) 
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uname ( C ) 
head(C) 
id(C) 
pwd(C) 

•tring8(C) find the 

Ipd(H) line 
xpd(H) transparent 
filter files for printing on LaserJet 
send/cancel requests to LP line 
setmode(C) 
turn on/off line 
Ipr(C) route named files to 
Ipdisable(C) enable/disable LP line 
Ipinit(M) add new line 
file 

formatted output 
hplp(C) hplpR(C) filter files for 
nice(C) run a command at a different 
nice<S) change 
brc(M) system initialization 
acct(S) enable or disable 
alarm(S) set a 
times (S) get 
init(M) 
exit(S) terminate 
fork(S) create a new 
getpid(S) get process. 

setpgrp(S) set 
setpgrp(C) execute comnand in a new 
get process, process group, and parent 
lock(S) lock a 
kill(C) terminate a 
nice(S) change priority of a 
kill(S) send a signal to a 
pclose(S) initiate pipe to/from a 
process IDs getpid(S) get 
P8(C) report 
plock(S) lock 
times (S) get process and child 
wait(S) wait for child 
ptrace(S) 
pause (S) suspend 
checklist (M) list file systems 
inittab(M> script for the init 
killalKC) kill all active 
send a signal to a process or a group of 
fuser(M) identify 
wait(C) wait conpletlon of background 
aHk(C) pattern scanning and 
nawk(C) pattern scanning and 
m4(CP) invoke a macro 
list (CP) 



prof ( CP ) display 
monitor(S) prepare execution 



print the current UNIX information 

print the first few lines of a stream 

print user and group ID and names 

print working directory name 



uname (C) 
head(C) 
id(C) 
pwd(C) 
strings (C) 



printable strings in an object file 
printenv(C) print out the environment printenv(C) 



printer daemon 

printer daemon 

printer hplp(C) hplpR(C) 
printer lp(C) cancel (C) 

printer modes utility 

printer scheduler 

printer spooler 

printers Ipenable(C) 

printers 



printers (M) print spooler configuration 

printf(S) sprintfCS) fprintf(S) print 

printing on LaserJet printer 

priority 



priority of a process 
procedure 



process accounting 

process alarm clock 

process and child process times 
process control initialization 

process 

process 



process group, and parent process IDs 

process group id 

process group 



process IDs getpid(S) 

process in primary memory 

process 

process 



process or a group of processes _ 

process popen(S) 

process, process group, and paren 

process status 

process, text, or data in memory 
process times 



process to stop or terminate 

process trace 

process until signal 

processed by fsck 

processes 

processes 



processes kilKS) 
processes using a 
processes 



file structure 



processing language 
processing language 
processor 



produce C source listing from COFF file 

prof (CP) display profile data 

prof (F) profile within a function 

profile data 

profile 



Ipd(H) 
xpd(H) 
hplp(C) 
lp(C) 

setmode(C) 

Ipon(M) 

Ipr(C) 

Ipenable(C) 

Ipinit(M) 

printers (M) 

printf (S) 

hplp(C) 

nice(C) 

nice(S) 

brc(M) 

acct (S) 

alarm(S) 

times (S) 

init(M) 

exit(S) 

fork(S) 

getpid(S) 

setpgrp(S) 

setpgrp(C) 

getpid(S) 

lock(S) 

kill(C) 

nice(S) 

kilKS) 

popen(S) 

getpid(S) 
. ps(C) 

plock(S) 

times (S) 
, wait(S) 

ptrace(S) 

pause(S) 

checklist (M) 

inittab(M) 

killalKC) 

kill(S) 

fuserlM) 

wait(C) 
. awk(C) 

nawk(C) 
. m4(CP) 

list (CP) 

prof (CP) 
, prof (F) 

prof (CP) 

monitor (S) 
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proflKS) execution time 
prof (F) 
time 

aaBert(S) verify 
boot(N) boot 
cxref(CP) generate C 
ctrace(CP) C 
edata(S) etext(S) last locations in 
tapeutil(C) utility 
uucico(N) file transport 
default (M) default 
sulogln(M) special login 
strclean(M) STREAMS error logger cleanup 
ua(C) user administration 
scheduler for the uucp file transport 
locate source, binary, or manual for 
cb(CP) beautify C 
lex(CF) generate 
update, and regenerate groups of 
xref(CP) cross-reference C 
xstr(CP) extract strings from C 
clock (M) 
labellt(C) 



screen display 
drand48(S) erand48(S) generate 
nrand48(S) lrand48(S) generate 
seed48(S) srand48(S) jrand48(S) generate 

uuto(C) uupick(C) 
adb(C) invoke x.out general 
ungate (S) 
puts(S) fputs(S) 
putc(S) putchar(S) putw(S) fputc(S) 
getdents(S) read directory entries and 
character or word on a stream putc(S) 
character or word on a stream 
environment 



stream 

a stream putc(S) putchar(S) 
file 



msgget(S) get message 
ipcrm(C) remove message 
qsort(S) 

run a comnand inaune to hangups and 

ranlib(CF) convert archives to 
randora(C) generate a 



profile 

profile within a function 

profile(M) set up environment at login 

profil(S) execution time profile 

program assertion 

program 



program cross-reference 

program debugger 

program end(S) 



program for a streaming tape drive 

program for uucp system 

program information directory 

program invoked by init 

program 

program 



program uu8ched(M) 
program whereis(C) 
programs 



programs for lexical analysis 

programs make(C) maintain, 

programs 

programs 



profil(S) 
prof (F) 
profile(M) 
profil(S) 
assert (S) 
boot(M) 
cxref (CP) 
otrace(CP) 
end(S) 
tapeutil(C) 
uucico(M) 
default (M) 
sulogin(M) 
strclean(M) 
ua(C) 

uusched(M) 
whereis(C) 
cb(CP) 
lex(CP) 
make(C) 
xref (CP) 
xstr(CP) 
clock (H) 
labelit(C) 
prs(CP) 
ps(C) 

pscreen(C) 
drand48(S) 
drand48(S) 
drand48(S) 
ptrace(S) 
uuto(C) 
adb(C) 
ungate (S) 
put8(S) 
putc(S) 
getdents(S) 
putc(S) 
putc(S) 
putenv(S) 

putm>g(S) send a message on a stream putmsg(S) 

putpwent(S) write password file entry putpwent(S) 

puts(S) fputs(S) put a string on a puts(S) 

putw(S) fputc(S) put character or word putc(S) 



provide access to the time-of-day chip 

provide labels for file systems 

prs(CP) print an SCCS file 

ps(C) report process status 



pscreen(C) set up terminal to print 
pseudo-random numbers 



pseudo-random numbers /mrand48(S) 
pseudo-random numbers drand48(S) 
ptrace(S) process trace 



public UNIX-to-UNIX system file copy 
purpose debugger 



push character back into input stream 
put a string on a stream 



put character or word on a stream 
put in a file 



putchar(S) putw(S) fputc(S) put 

putc(S) putchar(S) putw(S) fputc(S) put 
putenv(S) change or add value to 



pwck(M) grpck(M) check password/group 

pwd(C) print working directory name 

qsort(S) quicker sort 

query terminfo database 

queue 



rand(S) srand(S) simple 



pwck(M) 
pwd(C) 
qsort(S) 
tput(C) 
msgget ( S ) 

queue, semphore set. shared memory id ipcrm(C) 

qsort ( S ) 
nohup(C) 
quot(C) 
ranlib(CP) 
random (C) 
random (C) 
rand(S) 



quicker sort 

quits nohup(C) 

quot(C) sumnarize file system ownership 

random libraries 

random number 



random(C) generate a random number 
random-number generator 
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generator 
libraries 
f split (CP) split 
standard FORTRAN 
rat for (CP) convert 
system 
environment 
to be read 
getpaa(S) 
COFF file Idtbread(S) 
a COFF file Idahread(S) 
getdents (S) 
read(S) 
line(C) 

chec)< to see if there is data to be 
an archive file Idahread(S) 
lafhread(S) 

operations directory(S) telldir(S) 
Idaopen(S) open a common object file for 
open(S) open for 

lseel<(S) move 

locking(S) lock/unlock a file region for 
getuid(S) getegid(S) get 
getuid(S) geteuid(S) get 
getuid(S) getgid(S) get 
malloc(S) free(S) 
autoreboot (C) automatically 
reboot (C) automatically 
shutdn(S) reboot(S) shutdown or 
system 
shutdn(S) 

signal (S) specify what to do on 
lockf (S) 
last(C) print last 
script (C) make a 
frec(M) 
system from tape 
ed(C) 



make(C) maintain, update, and 
match routines 
match routines 

exec8eg(S) make a data 
locklng(S) lock/unlock a file 
regexp(S) compile 
routines regexp(F) 
search file for pattern using full 
regcmp(S) compile a 
regex(S) execute a 
regcmp(CP) compile 
accept (C) 
lorder(CP) find ordering 
Join(C) Join two 
COFF file ldr*eek(S) seek to 



rand(S) srand(S) simple randoa-number rand(S) 

ranlib(CP) convert archives to random ranlib(CP) 

ratfor files fspHt(CP) 

ratfor(CP) convert rational FORTRAN to ratfor(CP) 

rational FORTRAN to standard FORTRAN ratfor(CP) 

rcO(H) commands to atop the operating rcO(M) 

rc2(M) commands for multi-user rc2(M) 

rdchk(S) check to see if there is data rdchk(S) 

read a password getpas(S) 

read an Indexed symbol table entry of a _ Idtbread(S) 
read an indexed/named section header of _ Idshread(S) 
read directory entries and put in a file 
read from file 



read one line of input 
read rdchk(S) 



read the archive header of a member of 

read the file header of a COFF file 

readdir(S) opendir(S) directory 

reading Idopen(S) 

reading or writing 

read(S) read from file 

read/write file pointer 

read/write 



real/effective user or group IDs 

real/effective user or group IDs 

real/effective user or group IDs 

realloc(S) fast main memory allocator 

reboot the system 

reboot the system 

reboot the system 



reboot (C) automatically reboot the 



getdent8(S) 
read ( S ) 
llne(C) 
rdchk(S) 
Idahread(S) 
Idfhread(S) 
dlrectory(S) 
Idopen(S) 
open ( S ) 
read(S) 
l8eek(S) 
locking(S) 
getuid(S) 
getuld(S) 
getuid{S) 
malloc(S) 
autoreboot (C) 
reboot (C) 
ahutdn(S) 
reboot (C) 



reboot (S) shutdown or reboot the system _ shutdn(S) 



receipt of signal 

record locking on files 
record of user logins 



signal (S) 
lockf (S) 
last(C) 
script (C) 
frec(M) 
recover (C) 
ed(C) 

regcmp(CP) compile regular expressions regcmp(CP) 

regcmp(S) compile a regular expression regcmp(S) 



record of your terminal session 

recover files from a back-up tape 

recover(C) restore contents of a file 
red(C) Invoke the ed text editor 



regenerate groups of programs 

regexp(F) regular expression compile and 
regexp(S) compile regular expression and 

regex(S) execute a regular expression 

region executable 



make(C) 
regexp(F) 
regexp ( S ) 
regex ( S ) 
execseg ( S ) 
locking(S) 
regexp (S) 
regexp (F) 
egrep(C) 
regcmp ( S ) 
regex(S) 
regcmp ( CP ) 

reject (C) allow/prevent print requests accept (C) 

relation for object library lorder(CP) 

relations joln(C) 

relocation entries of a section of a Idrseek(S) 



region for read/write 

regular expression and match routines 
regular expression compile and match 

regular expression egrep(C) 

regular expression 

regular expression 

regular expressions 
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object (lie reloc(F) 
common object file 
leave (C) 
calendar (C) invoke a 
uuxqt (H) execute 
uutry(M) contact 
ct(C) spavm getty to a 
uux(C) execute command on 
rmdel(CP) 
rmdir ( S ) 
ssp(C) 
unlink (S) 
rm(C) nndlr(C) 
shared memory id ipcnii(C) 
COFF file atrip (CP) 
mv(C) move 
fsck(C) dfsck(C) check and 
uniq(C) report 
ye8(C) print a string 
clock(S) 
fsstat(H) 
tsinfo(M) 
facilities status ipcs(C) 
inodes df(H) 
sar(C) system activity 
sar(H) system activity 

P8(C) 

unig(C) 

fBeek(S) ftelKS) rewind(S) 
lp3ched(M) Ipshut(H) start/stop the LP 
accept (C) reject (C) allow/prevent print 
Ipsched(M) Ipiiiove(M) move LP 
sysaltoB(S) manufacturer specific system 
lp(C) cancel(C) send/cancel 
uuxqt (M) execute remote coonand 
reset (C) 

identify device name on which files 
wait and check access to semaphore 
restore. hd(C) 
tape recover (C) 
tape 

table entry Idgetname(S) 
stat(F) 
abs(S) 
logname(S) 
getenv(S) 
talse(C) 
true(C) 

rev(C) 

operations directory (S) closedir(S) 
stream fseek(S) ftell(S) 
creat(S) create a new file or 
directories 
uucp link 
tile 



relocation of information for a common 

reloc(P) relocation of information for a 

remind you when you have to leave 

reminder service 

remote command requests 

remote system with debugging on 

remote terminal 

remote UNIX 

remove a delta from an SCCS file 

remove a directory 



remove consecutive blank lines 
remove directory entry 



remove files or directories 

remove message queue, semphore set. _ 
remove symbols and line numbers from 

(rename) files and directories 

repair file systems 

repeated lines in a file 

repeatedly 



reloc(F) 
reloc(F) 
leave (C) 
calendar (C) 
uuxqt (M) 
uutry(M) 
ct(C) 
uux(C) 
rmdel(CP) 
rmdir (S) 
ssp(C) 
unlink (S) 
rm(C) 
ipcrm(C) 
strip (CP) 
mv(C) 
fsck(C) 
uniq(C) 
yes(C) 
clock(S) 
fsstat(M) 



report CPU time used 

report file system status 

report information about a file system fsinfo(H) 

report inter-process communication Ipcs(C) 

report number of free disk blocks and df (M) 

report package aar(C) 



report package 

report process status 

report repeated lines in a file 

reposition a file pointer in a stream 

request scheduler 

requests 

requests 

requests 

requests to LP line printer 

requests 

reset the teletype bit 

reset (C) reset the teletype bit 

reside devnm(C) 



resource waitsem(S) nbwaitsem(S) 
restore a hard disk from tape 



sar(M) 

ps(C) 

uniq(C) 

fseek(S) 

Ipsched(M) 

accept (C) 

Ipsched(M) 

aysaltos(S) 

lp(C) 

uuxqt (H) 

reset (C) 

reset (C) 

devnm(C) 

wait8em(S) 

restore. hd(C) 



restore contents of a file system from recover(C) 



restore. hd(C) restore a hard disk from 

retrieve symbol name for COFF symbol 

return data by stat system call 

return integer absolute value 

return login name of user 



return value for environment name 
return with a nonzero exit value _ 

return with a zero exit value 

rev(C) reverse lines of a file 

reverse lines of a file 



rewinddir(S) seekdlr(S) directory 

rewind(S) reposition a file pointer in a 
rewrite an existing one 



rm(C) rmdir(C) remove tiles or 
rmail(C) receives mail from 



rmdel(CP) remove a delta from an SCCS 



restore. hd(C) 

Idgetname(S) 

stat(F) 

abs(S) 

logname(S) 

getenv ( S ) 

false(C) 

true(C) 

rev(C) 

rev(C) 

directory(S) 

fseek(S) 

creat(S) 

rm(C) 

rmalKC) 

rmdel(CP) 
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nn(C) 

chroot(S) change 
chroot ( C ) change 
exponential, logarithm, and square 
Ipr(C) 

Idfcn(F) coiimon object file access 
regular expression compile and match 
compile regular expression and match 
interpreter sh(C) 
nice(C) 
quits nohup(C) 
activity 
system activity 



archive (C) 
allocation brk(S) 
bfs(C) 
formatted input 
awk(C) pattern 
nawk(C) pattern 
cdc(CP) change the delta commentary of 
comb (CP) combine 
delta (CP) make a change to an 
aact(CP) print current 
get (CP) get a version of an 
prs(CP) print an 
rmdel(CP) remove a delta from an 
sccsdiff(CF) compare two versions of an 
BCCsfile(F) format of an 
unget(CP) undo a previous get of an 
val(CP) validate an 
admin (CP) create and administer 
sees file 

turn on/off 

ckbupscd(M) check file system backup 
turn on/off 
program uu8ched(M) 
Ipshut(M) start/atop the LP request 
object file 
image file 
more(C) view a file one full 
clear (C) clear terminal 
pscreen(C) set up terminal to print 
curses (S) terminal 
scr_dump(F) format of curses 
vi(C) invoke a 
inittab(M) 
session 

to a shared data segment 
data segment sdget(S) 
shared data segment 
data access 



nndir(C) remove tiles or directories 

rmdir(S) remove a directory 

root directory 



root directory for command 

root functions exp(S) aqrt(S) 

route named files to printer spooler 
routines 



routines regexp(F) 

routines regexp(S) 

rsh(C) invoke the shell command 

run a command at a different priority 
run a conmand iimune to hangups and 
sact(CP) print current SCCS file edit 

sadcon(M) data collector 

aar(C) syst 



activity report package 
Bar(H) system activity report package 
save a file system to a streaming tape 

sbrk(S) change data segment space 

scan big files 



scanf(S) fscanf(S) sscanf(S) convert 

scanning and processing language 

scanning and processing language 

SCCS delta 

SCCS deltas 

SCCS file 



SCCS file edit activity 

SCCS file 

SCCS file - 

SCCS file 

SCCS file 

SCCS file 

SCCS file 

SCCS file 

SCCS files 



scc8ditf(CF) compare two versions of an 

sccsflle(F) format of an SCCS file 

scheduler for line printer 

schedule 



scheduler for line printer 

scheduler for the uucp file transport 
scheduler Ipsched(M) 



scnhdr(F) section header for a common 

scr_dump(P) format of curses screen 

screen at a time 

screen 

screen display 

screen handling and optimization package 
screen image file 



screen-oriented display editor 

script for the init processes 

script (C) make a record of your terminal 
sdb(C) symbolic debugger 



sdenter(S) sdleave(S) synchronize access 

sdfree(S) attach and detach a shared 

sdget(S) 8dfree(S) attach and detach a _ 
8dgetv(S) sdwaitv(S) synchronize shared 
sdiff (C) compare files side-by-side 



rm(C) 

rmdir(S) 

chroot (S) 

chroot (C) 

exp(S) 

Ipr(C) 

Idfcn(F) 

regexp(F) 

regexp ( S ) 

sh(C) 

nice(C) 

nohup(C) 

sect (CP) 

sadcon(M) 

sar(C) 

sar(M) 

archive (C) 

brk(S) 

bfa(C) 

scanf (S) 

awk(C) 

nawk(C) 

cdc(CP) 

comb (CP) 

delta (CP) 

sect (CP) 

get (CP) 

prs(CP) 

rmdel(CP) 

sccsdiff (CP) 

sccsf ile(F) 

unget ( CP ) 

val(CP) 

admin (CP) 

sccsdiff (CP) 

sccafile(F) 

Ipon(M) 

ckbupscd(M) 

Ipon(M) 

uusched(H) 

Ipsched(M) 

scnhdr(F) 

scr_dximp(F) 

more(C) 

clear(C) 

pscreen(C) 

curses (S) 

scr_dump(F) 

. vi(C) 
inittab(M) 
script (C) 

. 3db(C) 
sdenter(S) 
sdget(S) 
3dget(S) 
sdgetv(S) 
sdif t(C) 
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shared data segment adenter(S) 
accesa sdgetv(S) 
fgrep(C) 
grep(C) 

Isearch(S) Iflnd(S) linear 
regular expression egrep(C) 
bsearch(S) binary 
hdestroy(S) bcreate(S) manage hash 
tdelete(S) twalkCS) manage binary 
enroll (C) xsend(C) xget(C) 
acnhdr(F) 

Idshread(S) read an indexed/named 
manipulate the object file conment 
seek to line number entries of a 
seek to relocation entries of a 
slze(C) print 
add new bad sectors to the bad 
badblock(C) add new bad 



pseudo-random numbers drand48(S) 
of a COFF file ldl8eek(S) 
of a COFF file Idrseek(S) 
common object Idohseek(S) 
Idtbseek(S) 

directory (S) cloBedir(S) rewlnddir(S) 
shmget(S) get shared memory 
synchronize access to a shared data 
attach and detach a shared data 
brk(S) sbrk(S) change data 
dump (CP) dump 
hdr(C) display 
files conni(C) 
semctl(S) 

creataem(S) create a binary 
opensem(S) open a 
sefflop(S) 

nbwaitsem(S) wait and check access to 
senget(S) get set of 



ipcrm(C) remove message queue, 
putmsg(S) 
processes kill(S) 
lp(C) cancel(C) 
mesg(C) allow or disallow messages 
calend«r(C) invoke a reminder 
script (C) make a record of your terminal 
alarm(S) 
umask(S) 

ascll(H) map of the ASCII character 
timezone(M) 
env(C) 
utlme(S) 
uinask(C) 

log in numusers(S) get and 



sdleave<S) synchronize accesa to a 

sdwaitv(S) synchronize shared data 

search a file tor a character string 

search a file for a pattern 

search and update 



search file for pattern using full 

search of a sorted table 

search tables hsearch(S) 



search trees tsearch(S) tflnd(S) 
secret mail 



section header for a common object file 

section header of a COFF file 

section mcs(CP) 



section of a COFF file Idlseek(S) 

section of a COFF file Idrseek(S) 

section sizes of coonon object files 
sector map badblock(C) 



sectors to the bad sector map 

sed(C) invoke the stream editor 
see(C) display a file 



seed48(S) srand48(S) Jrand48(S) generate 
seek to line number entries of a section 
seek to relocation entries of a section 

seek to the optional file header of a 

seek to the symbol table of a COFF file 

seekdlr(S) directory operations 

segment identifier 



segment sdenter(S) sdleave(S) 

segment sdget(S) sdfree(S) 

segment space allocation 



selected parts of an object file 

selected parts of an object file 

select/reject lines common to two sorted 

semaphore control operations 

semaphore 

semaphore 

semaphore operations 

semaphore resource waltsem(S) 

semaphores 



sdenter (S) 

sdgetv(S) 

fgrep(C) 

grep(C) 

Isearch ( S ) 

egrep(C) 

bsearch(S) 

hsearch(S) 

tsearch(S) 

enroll (C) 

8cnhdr(F) 

Idshread(S) 

mcs(CP) 

Idlseek(S) 

Idrseek(S) 

size(C) 

badblock(C) 

badblock(C) 

. sed(C) 
see(C) 
drand48(S) 
Idlseek(S) 
Idrseek(S) 
Idohseek(S) 
ldtb8eek(S) 
directory (S) 
shmget(S) 
sdenter(S) 
sdget(S) 

. brk(S) 
dufflp(CP) 

, hdr(C) 
conm(C) 
semctl(S) 
creatsem(S) 
opensem(S) 
semop(S) 
waitsem(S) 
semget(S) 



semctl(S) semaphore control operations semctKS) 



semget(S) get set of semaphores 

semop(S) semaphore operations 

semphore set. shared memory id 
send a message on a stream 



send a signal to a process or a group of 
send/cancel requests to LP line printer 

sent to a terminal 

service 

session 

set a process alarm clock 

set and get file creation mask 

set 

set default system time zone 

set environment for command execution 

set file access and modification times 
set file-creation mode mask 



set maximum number of users allowed to 



semget ( S ) 

semop ( S ) 

Ipcrm(C) 

putmsg(S) 

klll(S) 

lp(C) 

mesg(C) 

calendar (C) 

script (C) 

alarin(S) 

umask(S) 

ascll(H) 

timezone(H) 

env(C) 

utlme(S) 

umask(C) 

numusers(S) 
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semget(S) get 
pconf ig(C) 
setpgrp(S) 

ipcrm(C) remove message queue, semphore 
tabs(C) 
getty(M) 
taet(C) 

discipline uugetty(M) 
date(C) print and 
stty(C) 
3ttty(C) 
asktime(C) 
stlme(S) 
proflle(M) 
pscreen(C) 
setmodem(C) 
shuttype(S) get and 
setuid(S) 
ullmit(S) get and 
a stream 

getgrent(S) fgetgrent(S) endgrent(S) 



process group 

getpwent(S) fgetpwent(S) endpHent(S) 
modification dates of files 
gettydefB(M) speed and terminal 

file entry getut(S) 
setbut(S) 
sputl(S) 

sdgetv(S) sdHaltv(S) synchronize 
sdleave(S) synchronize access to a 
sdget(S) sdfree(S) attach and detach a 
chkshlib(CP) tool for comparing 
mkshllb(CP) create a 
shmctKS) 

remove message queue, semphore set. 

shiiiop(S) 
shnget(S) get 
Interpreter 
bsh(C) Invoke the Business 
sh(C) rsh(C) invoke the 
syntax csh(C) 
system (S) issue a 
create menu systera(8) for the Business 
menus (H) format of Business 

operations 
identifier 

nap(S) suspend execution for a 
the system 
shutype(H) UPS 



set of semaphores 

set port configuration 

set process group id 

set. shared memory id 

set tabs on a terminal 

set terminal mode 

set terminal modes 

set terminal type, modes, speed, line 
set the date 



set the options for a port 
set the options for a port 
set the system time of day 
set time 



set up environment at login time 

set up terminal to print screen display 

set up tty port for a modem 

set UPS shutdown limits 

set user and group IDs 

set user limits 



setbuf(S) setvbuf(S) assign buffering to 

setgrent(S) get group file entry 

setjmp(S) longjmp(S) non-local goto 

3etmnt(C) establish /etc/mnttab table 

setmode(C) printer modes utility 



setmodem(C) set up tty port for a modem 

setpgrp(C) execute comnand in a new 

setpgrp(S) set process group id 

setpwent(S) get password file entry 

settime(C) change the access and 

settings used by getty 



setuld(S) set user and group IDs 

setutent(S) getutline(S) access utmp 

aetvbuf(S) assign buffering to a stream 

sgetl(S) access long Integer data 

shared data access 



shared data segment 8denter(S) 

shared data segment 

shared libraries 

shared library 



shared memory control operatic 

shared memory id Ipcm(C) 

shared memory operations 



shared memory segment identifier 

sh(C) rsh(C) invoke the shell command 

shell 

shell comnand Interpreter 



shell command Interpreter with C-like 

shell command 

Shell digest (C) 

Shell menu system 



shl(C) shell layers 

ShmctKS ) shared memory control 

shfflget(S) get shared memory segment 

shmop(S) shared memory operations 

short Interval 



shutdn(S) reboot (S) shutdown or reboot 
shutdown configuration utility 



semget ( S ) 

pconf lg(C) 

setpgrp(S) 

ipcrm(C) 

tabs(C) 

getty(M) 

tset(C) 

uugetty (N) 

date(C) 

atty(C) 

xtty(C) 

asktime(C) 

stime(S) 

profile (M) 

p8creen(C) 

setmodem ( C ) 

shuttype(S) 

setuid(S) 

ulimit(S) 

setbuf (S) 

{(etgrent(S) 

setjmp(S) 

setmnt(C) 

setmode(C) 

setmodem (C) 

setpgrp(C) 

setpgrp(S) 

getpwent ( S ) 

settime(C) 

Settydef8(M) 

setuld(S) 

getut(S) 

setbuf (S) 

. sputl(S) 
sdgetv(S) 
sdenter(S) 
sdget(S) 
chkshlib(CP) 

. mk8hllb(CP) 
ShmctKS) 
ipcrm(C) 
shmop(S) 
shmget(S) 

. sh(C) 
bsh(C) 

. ah(C) 

. csh(C) 
system(S) 
digest (C) 
menus (M) 
shl(C) 
shmctKS) 
shmget(S) 
shmop(S) 
nap(S) 
shutdn(S) 
shutype(M) 
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shuttype(S) get and set UPS 
ahutdnCS) reboot(S) 
bring Bystem to single-user or 
or shutdown 
limits 
utility 

sdiff(C) compare files 
signal management sigset(S) 

sigset(S) slghold(S) slgrel8e(S) 
sighold(S) slgrelse(S) sigignore(S) 
sigset(S) sigpause(S) 
pause(S) suspend process until 
specify what to do on receipt of 
processes kill(S) send a 
of signal 

sslgnal(S) gsignal(S) software 
sigset(S) 

management sigset(S) sighold(S) 
sigignore(S) signal management 

rand(S) srand(S) 
fmt(C) 

shutdown (M) bring system to 
multi/single-user mode multiuser(C) 
functions 

trigonometric functions trig(S) 
chsize(S) change the file 
sizefs(C) determine the 
object tiles 
logical disk drive 
size(C) print section 
interval 

user ttyslot(S) find the 
spline (C) interpolate 
intro(CP) introduce 
ssignal(S) gsignal(S) 
tsort(C) 
8ort(C) 
qsort(S) quicker 

select/reject lines comnon to two 
look(C) find lines in a 
bsearch(S) binary search of a 
wfaereis(C) locate 
list (CP) produce C 
create an error message tile from C 
create an error message tile from C 
tic(C) compile terminto 
brk(5) sbrk(S) change data segment 
ct(C) 

makedevs (M) create 
makettys(H) create tty 
mknod(C) build 
sulogin(M) 

mknod(S) make a directory, or a 
sysaltos(S) manufacturer 



shutdown limits 

shutdown or reboot the system 
shutdown shutdown (H) 



shutdown (H) bring system to single-user 

shuttype(S) get and set UPS shutdotm 

shutype(H) UPS shutdown configuration 

side-by-side 



slghold(S) sigrelse(S) siglgnore(S) 

sigignore(S) signal management 

signal management slgset(S) 

signal management 

signal 

signal signal (S) 

signal to a process or a group of 



shut type ( S ) 

shutdn(S) 

shutdown(M) 

shutdown(M) 

shuttype(S) 

shutype(M) 

sdiff (C) 

sigset(S) 

sigset(S) 

sigsetlS) 

sigset (S) 

pause ( S ) 

signal (S) 

kill(S) 



signal (S) specify what to do on receipt _ signal (S) 



signals 

slgpause(S) signal management 

sigrelse(S) sigignore(S) signal 

sigset (S) sighold(S) slgrelse(S) 

sigset (S) sigpause(S) signal management 

simple random-number generator 

simple text formatter 

single-user or shutdown 

singleuser (C) bring system up 

sinh(S) cosh(S) tanh(S) hyperbolic 

sin(S) cos(S) tan(S) asin(S) acos(S) 

size 

size of a logical disk drive 

slze(C) print section sizes of consion 

sizets(C) determine the size of a 

sizes of common object files 



sleep(C) suspend execution for an 

sleep(S) suspend execution for interval 

slot in the utmp file of the current 

smooth curves 



software development conmands 
software signals 



sort a file topologically 

sort and merge files 

sort 



sort(C) sort and merge tiles 

sorted tiles coiini(C) 

sorted list 

sorted table 



source, binary, or manual for program 

source listing from COFP file 

source mkstr(C) 

source mkstr(CP) 

source 

space allocation 

spawn getty to a remote terminal 

special device files 

special tiles 

special files 



special login program Invoked by init 

special or ordinary file 

specific system requests 



ssignal(S) 

sigset (S) 

sigset ( S ) 

sigset ( S ) 

sigset ( S ) 

rand(S) 

fmt(C) 

shutdown (M) 

multiuser (C) 

sinh(S) 

trig(S) 

chslze(S) 

sizets(C) 

size(C) 

sizefs(C) 

size(C) 

sleep(C) 

sleep(S) 

ttyslot(S) 

spline (C) 

intro(CP) 

ssignal(S) 

t8ort(C) 

sort(C) 

qsort(S) 

sort(C) 

coami(C) 

. look(C) 
bsearch(S) 

_ whereis(C) 

. list (CP) 

_ mkstr(C) 

_ mkstr(CP) 

. tic(C) 

. brk(S) 

. ct(C) 
makedevs (H) 
makettys(M) 
mknod(C) 
8Ulogin(M) 
mknod(S) 
sysaltos(S) 
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fspec(F) format 
cron(C) execute commands at 
signal (S) 
getty gettydefs(M) 
uugetty(M) set terminal type, modes, 
find spelling errors 

split(C) 
csplit(C) 
f split (CP) 

uucleanup(M) uucp 
printers (M) print 
Ipr(C) route named files to printer 
Ipadmin(M) configure the LP 
output print f(S) 
data 

square root functions exp(S) 
sqrt(S) exponential, logarithm, and 
pseudo- random/ drand43(S) 3eed48(S) 
rand(S) 
scanf(S) fscanf(S) 



stdlo(S) 

rat for (CP) convert rational FORTRAN to 
gets(C) get a string from the 
package stdipc(S) ftok(S) 
pr(C) print files on the 
Ipsched(H) Ipshut(H) 
stat(F) return data by 

information 
ustat(S) get file system 

fsstat(M) report file system 
Ipstat(C) print LP 
fileno(S) clearerr(S) feof(S) stream 
uustat(C) uucp 
inter-process communication facilities 
ps(C) report process 
stat(S) fstat(S) get file 
package 

coaamnlcation package 

wait(S) wait for child process to 
rcO(M) commands to 
functions dlMi(S) flrBtkey(S) 

string operations 3trlng(S) 
string(S) strncmp(S) strcpy(S) 8trlen(S) 
program 

string(S) strcat(S) strdup(S) strpbrk(S) 
operations string(S) strnanp(S) 
operations string(S) strcat(S) 
sed(C) invoke the 
fclose(S) fflush(S) close or flush a 



specification in text files 
specified times 



specify uhat to do on receipt of signal 

speed and terminal settings used by 

speed, line discipline 

spelKC) 

spline(C) Interpolate smooth curves 

split a file into pieces 



split files according to context 
split ratfor files 



split (C) split a file into pieces 

spool directory cleanup 

spooler configuration file 

spooler 



spooling system 

sprintf(S) fprintf(S) print formatted 
sputl(S) sgetl(S) access long Integer 

sqrt(S) exponential, logarithm, and 

square root functions exp(S) 



srand48(S) Jrand48(S) generate 

srand(S) simple random-number generator 
sBcant(S) convert formatted input 



fspec(F) 

cron(C) 

signal (S) 

gettydefs(M) 

uugettY(M) 

spell (C) 

spline(C) 

split (C) 

csplit(C) 

fsplit(CP) 

split (C) 

uucleanup(M) 

printers (M) 

Ipr(C) 

Ipadmin(M) 

printf (S) 

sputl(S) 

exp(S) 

exp(S) 

drand48(S) 

rand(S) 

scanf (S) 



ssignal(S) gaignal(S) software signals sslgnaKS) 



ssp(C) remove consecutive blank lines _ 
standard buffered input/output package 

standard FORTRAN 

standard input 



standard interprocess connunication 
standard output 



start /stop the LP request scheduler 
Stat system call 



88p(C) 

stdlo(S) 
rat for (CP) 
gets(C) 
stdipc(S) 
pr(C) 

Ipsched(M) 
stat(F) 
stat(F) 
statfs(S) 
ustat(S) 
stat(S) 
fs8tat(M) 
Ipstat(C) 
f error (S) 
uustat(C) 
ipcs(C) 
ps(C) 
stat(S) 
stdio(S) 



stat(F) return data by stat system call 

statfs(S) f8tatfs(S) get file system [ 

statistics 

stat(S) fstat(S) get file status 

status 

status information 

status inquiries f error (S) 

status inquiry and job control 

status Ipcs(C) report 

status 

status 

stdio(S) standard buffered input/output 
stdipc(S) ftok(S) standard Interprocess _ stdipc(S) 

stime(S) set time stime(S) 

wait(S) 
rcO(M) 
dbin(S) 

strace(M) print STREAMS trace messages strace(M) 

strcat(S) strdup(S) strpbrk(S) strcmp(S) string(S) 

strchr(S) string operations string(S) 

strclean(M) 
strlng(S) 

strcpy(S) strlen(S) strchr(S) string string(S) 

strdup(S) strpbrk(S) strcmp(S) string string(S) 

stream editor 3ed(C) 

stream fclose(S) 



stop or terminate 

stop the operating system 

8tore(S) fetch(S) perform database 



strclean(M) STREAMS error logger cleanup 
atrcmp(S) string operations 
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fopen(S) fdopen(S) f reopen (S) open a 
rewind(S) reposition a tile pointer in a 
getchar(S) get character or word from a 
getiiisg(S) get next message off a 
gets(S) fgets(S) get a string from a 
head(C) print the first few lines of a 
fputc(S) put character or word on a 
putmsg(S) send a message on a 
puts(S) fputs(S) put a string on a 
setvbuf(S) assign buffering to a 
f error (S) £ileno(S) clearerr(S) feof(S) 
ungetc(S) push character back into input 
archive(C) save a file system to a 
tapeutil(C) utility program tor a 
clone (n) open any minor device on 
strclean(M) 
strerr(M) 
log(M) interface to 
poll(S) 
8trace(M) print 

between long Integer and base-64 ASCII 
localtime(S) convert date and time to 
cttime(S) convert date and time to 
ecvt(S) convert floating-point number to 
fgrep(C) search a file for a character 
gets(S) fgets(S) get a 
gets(C) get a 
mlcvers(CP) generate a what 
puts(S) fputB(S) put a 
strcat(S) strdup(S) strpbrk(S) strcmp(S) 
strncmp(S) strcpy(S) strlen(S) strchr(S) 
string(S) strspn(S) strtok(S) 
yes(C) print a 
8trtod(S) atof(S) convert 
strtol(S) atol(S) atoi(S) convert 
xstr(CF) extract 
strings(C) find the printable 
strcaip(S) string operations 
strchr(S) string operations 
operations 
an object file 
nuBibers froai COFF file 
string(S) stmcmplS) strcpy(S) 
string operations string(S) 
string(S) strcat(S) strdup(S) 
string(S) 
double-precision number 
string(S) strapn(S) 
to Integer 

identify processes using a file or file 
mount (C) umount(C) ■ount/uniaount a file 

plot(S) graphics interface 
another user 
by init 
blocks in a file 



stream fseek(S) ftell(S) 

stream getc(S) getw(S) fgetc(S) 

stream 

stream 

stream 



stream putc(S) putchar(S) putw(S) 

stream 

stream 



stream setbuf(S) 

stream status inquiries 
stream 



streaming tape 

streaming tape drive 
STREAMS driver 



STREAMS error logger cleanup program 

STREAMS error logger daemon 

STREAMS error logging 



STREAMS input /output multiplexing 
STREAMS trace messages 



strerr(M) STREAMS error logger daemon 

string a641(S) 164a(S) convert 

string ctime(S) gmtime(S) 



string ctime(S) tzset(S) asctime(S) 

string 

string 

string from a stream 

string from the standard input 

string 



string on a stream 

string operations string(S) 
string operations string(S) 

string operations 

string repeatedly 



string to double-precision number 

string to integer 

strings from C programs 



strings in an object file 

string(S) street (S) strdup(S) strpbrk(S) 
string(S) stmcmp(S) strcpy(S) strlen(S) 

strlng(S) strspn(S) strtok(S) string 

strlngs(C) find the printable strings in 

strip (CP) remove symbols and line 

strlen(S) strchr(S) 



itring operations 

stmcmp(S) strcpy(S) strlen(S) strchr(S) 
strpbrk(S) strcBp(S) string operations atring(S) 



f open ( S ) 
fseek(S) 
getc(S) 
getmsg(S) 
gets(S) 
head(C) 
putc(S) 
putmsg(S) 
put8(S) 
setbuf (S) 
f error (S) 
ungetc(S) 
archive (C) 
tapeutil(C) 
clone (M) 
strclean(M) 
strerr(M) 
log(M) 
poll(S) 
St race (M) 
strerr(M) 
8641 (S) 
ctime(S) 
ctime(S) 
ecvt(S) 
tgrep(C) 
get8(S) 
gets(C) 
mkvers(CP) 
puts(S) 
8tring(S) 
string (S) 
string(S) 
ye8(C) 
strtod(S) 
strtol(S) 
xstr(CP) 
strings(C) 
string(S) 
string(S) 
»tring(S) 
strings (C) 
strip(CP) 
atring(S) 
string(S ) 



strspn(S) strtok(S) string operations 

strtod(S) atof{S) convert string to 

strtok(S) string operations 

strtol(S) atoKS) atoi(S) convert string 

structure tuser(M) 

structure 

stty(C) set the options for a port 

subroutines 

su(C) make the user a super-user or 

sulogin(M) special login program invoked 
sum(C) calculate checksum and count 



string (S) 

»trtod(S) 

3tring(S) 

strtol(S) 

fuser(M) 

mount (C) 

stty(C) 

plot(S) 

su(C) 

sulogin(M) 
sum(C) 
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du(C) 
quot (C) 
3ync(S) update 
aync(C) update the 
su(C) make the user a 
terminals (M) list of 
nap(S) 
sleep(C) 
sleep(S) 
pause(S) 

swab(S) 
swap(C) change 

Idgetname(S) retrieve 
retrieve symbol name for COFF 
Idtbindex(S) compute the index of a 
Idtbread(S) read an indexed 
syms(F) common object file 
make bootable system file with driver 
make bootable system file with kernel 
Idtbseek(S) seek to the 
uniatd(F) file header for 
sdb(C) 
St rip (CP) remove 
glos3ary(C) define common UNIX terms and 
format 

segment sdenter(S) sdleave(S) 
sdgetv(S) sdwaitv(S) 

shell command interpreter with C-like 
lint (CP) check C language usage and 
requests 
information 
information 

messages sys_nerr(S) 
information 
system error messages 
login(C) give you 
acct(C) accounting 

sar (C) 
sar(M) 

Inlr(N) clean the file 
ckbupscd(M) check file 
stat(F) return data by stat 
intro(S) introduce 
aysconftC) get 
sysconf(S) get 
cu(C) call another UNIX 
types (F) primitive 
f8db(M) file 
sysdet(M) output 
perror ( S ) 

sys_nerr(S) sys_errlist (S) errno(S) 



rize disk usage 



ize file system omership 

super block 

super-block 



super-user or another user 
supported terminals 



suspend execution for a short interval 

suspend execution for an interval 

suspend execution for interval 

suspend process until signal 

swab(S) swap bytes 

swap bytes 



swap device configuration 

swap(C) change swap device configuration 
symbol name for COFF symbol table entry 
symbol table entry Idgetname(S) 



symbol table entry of a COFF file 
symbol table entry of a COFF file 

symbol table format 

symbol table mkunix(M) 

symbol table mkunix(M) 

symbol table of a COFF file 

symbolic constants 

symbolic debugger 



symbols and line numbers from COFF file 

symbols 

syms(F) common object file symbol table 
sync(C) update the super-block 



synchronize access to a shared data 

synchronize shared data access 

sync(S) update super block 

syntax csh(C) 

syntax 

sysaltos(S) manufacturer specific systei 

sysconf(C) get system configuration 

sysconf(S) get system configuration 

sysdefCM) output system definition 

sys_errlist(S) errno(S) system error 

sysfs(S) get file system type 

sy»_nerr(S) sys_errllBt(S) errno(S) 

system access 

system 

system activity data collection 

system activity report package 

system activity report package 

system and executes init 

system backup schedule 

system call 

system calls, functions, and libraries 



system configuration Information 
system configuration information 
system 



system data types 

system debugger 

system definition 

system error messages 
system error messages 



du(C) 
quot(C) 
sync ( S ) 
sync(C) 
su(C) 

terminals (M) 

nap(S) 

sleep(C) 

sleep(S) 

pause(S) 

swab ( S ) 

swab ( S ) 

swap(C) 

swap(C) 

ldgetname(S ) 

Idgetname ( S ) 

Idtbindex(S) 

Idtbread(S) 

sym3(F) 

mkunix(M) 

mkunix(H) 

Idtbseek(S) 

unistd(F) 

adb(C) 

strip(CP) 

glossary (C) 

sym8(F) 

sync(C) 

sdenter(S) 

sdgetv(S) 

sync(S> 

, csh(C) 
lint (CP) 
sysaltos(S) 
sysconf(C) 
sysconf(S) 
sysdef (M) 
sys_nerr(S) 
sysfs(S) 
sys_nerr(S) 

. login (C) 
acct(C) 
sadcon(M) 
sar(C) 

. sar(H) 
inir(M) 
ckbupscd(N) 
stat(F) 

_ intro(S) 
aysconf (C) 
sysconf(S) 

. cu(C) 
types (F) 
fsdb(M) 

. sysdef (M) 
perror (S) 
sys_nerr(S) 
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uuto(C) uupick(C) public UNIX-to-UNIX 
mkunix(H) make t>ootable 
inkunlx(M) make bootable 
recover(C) restore contents of a file 
report information about a file 
help(C) 

f3typ(M) determine the file 
clirent(F) file 
statfs(S) fstatfs(S) get file 
brc(M) 

Ipadmin(N) configure the LP spooling 
mail (C) 

menus (M) format of Business Shell menu 
mkfs(M) construct a file 
mount (S) mount a file 
quot(C) summarize file 
rcO(n) commands to stop the operating 
reboot (C) automatically reboot the 
sysaltos(S) manufacturer specific 
reboot (S) shutdown or reboot the 
ustat(S) get file 
fsstat(M) report file 
fstab(M) file 
mnttab(M) mounted file 
asktime(C) set the 
timezone(M) set default 
archive(C) save a file 
shutdown(H) bring 
ByBf8(S) get file 
uname(S) get name of current UNIX 
multiuser(C) singleuser(C) bring 
file transport program for uucp 
fileayBtem(H) format of a 
who(C) display who is on the 
uutry(H) contact remote 
volcopy(M) labelit(M) copy file 
haltsys(C) close the file 
digest (C) create menu 
fsck(C) dfsck(C) check and repair file 

labelit(C) provide labels for file 
umountall(C) mount/unnount multiple file 
checklist (N) list file 
bsearchCS) binary search of a sorted 
retrieve symbol name for COFF symbol 
compute the index of a symbol 
Idtbread(S) read an indexed symbol 
syms(F) coiaaon object tile symbol 
fstab(M) tile system 
bootable system tile with driver symbol 
bootable system file with kernel symbol 
mnttab(M) mounted tile system 
Idtbseek(S) seek to the symbol 
setmnt(C) establish /etc/mnttab 
hcreate(S) manage hash search 
tab8(C) set 



system file copy 

system file with driver symbol table 
system file with kernel symbol table 

system from tape 

system fsinfo(M) 



system help facility 

system identifier 

system independent directory entry 
system information 



system initialization procedure 

system 

system mail 

system 

system 

system 



system ownership 

system 

system 



system requests 

system shutdn(S) 
system statistics 

system status 

system table 

system table 



system time of day 
system time zone 



system to a streaming tape 

system to single-user or shutdown 

system type information 

system 



system up multi/single-user mode 

system uucico(M) 

system volume 

system 



system with debugging on 

system with label checking 
systems and halt the CPU 



system(s) for the Business Shell 
systems 



system(S) issue a shell command 
systems 



systems mountall(C) 

systems processed by fsck 
table 



table entry Idgetname(S) 

table entry of a COFF file Idtbindex(S) 

table entry of a COFF file 

table format 

table 



table mkunix(M) make 
table mkunix(M) make 
table 



table of a COFF tile 
table 



tables hsearch(S) hdestroy(S) 

tabs on a terminal 

tabs(C) set tabs on a terminal 



uuto(C) 

mkunix(M) 

mkunix(M) 

recover (C) 

fslnfo(M) 

help(C) 

fstYp(M) 

dirent(F) 

statfs(S) 

brc(M) 

Ipadmin(M) 

mail(C) 

menus (M) 

mkfs(M) 

mount ( S ) 

quot(C) 

rcO(M) 

reboot (C) 

sysaltos(S) 

shutdn(S) 

ustat(S) 

fs8tat(M) 

fstab(M) 

mnttab(M) 

asktime(C) 

timezone(M) 

archive (C) 

shutdown (M) 

sysfs(S) 

uname ( S ) 

multiuser (C) 

uucico(M) 

filesystem(M) 

who(C) 

uutry(M) 

volcopy(M) 

haltsys(C) 
_ digest (C) 
_ fsck(C) 

sy8tem(S) 
_ labelit(C) 

mountall(C) 
checklist (M) 
bsearch(S) 
Idgetname(S) 
Idtbindex(S) 
Idtbread(S) 
syms(F) 
fstab(M) 
mkunix(M) 
mkunix(N) 
_ mnttab(M) 
_ Idtbseek(S) 
setmnt(C) 
hsearch(S) 
tabs(C) 
tab8(C) 



PI-48 



Permuted Index 



ctags(C) create a tags file 



slnh(S) coah(S) 
functiena trlg(S) aln(S) Goa(S) 
save a file syatea to a atreamlng 
utility prograa for a atreaming 
dump contanta of a hard dlak to 
frec(M) recover fllaa fron a back-up 
restore contenta of a tile ayateni from 
restore. hd(G) restore a hard disk from 
atreaming tape drive 

treea tsearch(S) tfind(S) 
tee(C) create a 

tk(C) paginator for 
react (C) reset the 
directory operationa dlrectory(S) 
file tmpnain(S) 
tmptlle(S) create a 
tnipnain(S) te<iipnaiii(S) create a name for a 
captoinfo(M) convert 

tenncap(M) 
terminfe(M) 
ct(C) spawn getty to a remote 
cteniiid(S) generate file name for 
termio(M) general 
dial(S) establlah an out -going 
virtual 

allow or disallow mcsaages sent to a 
getty(M) aet 
taet(C) aet 
clear<C) clear 
optimization package curses(S) 
script (C) make a record of your 
gettydefa(M) apeed and 
taba(C) set tabs on a 
pscreen(C) set up 
ttyname(S) isatty(S) find name of a 
diseipliae uugettycw set 
ttya(M) login 
terminals (M) llat of a«pperted 
tem(Mj eenvantienai names for 

kill(C) 
erratep(C) 
exlt(S) 

wait for child preceaa to atop or 
qfsery 

captoinfo(M) convert temeap to 
infoomplH) compare or print 
tie(e) compile 



gi088ary(C) deCine 



tail(C) deliver the laat part of a file 
tanh(S) hyperbolic functiona 



tan(S) aBin(S) acoa(S) trigonometric 

tape archive(C) 

tape drive tapeutil(C) 

tape dump.hd(C) 

tape 

tape recover (C) 

tape 



tapeutil(C) utility program for 
tar(C) archive filea 



tdelete(S) twalk(S) manage binary aearch 
tee in a pipe 



tee(C) create a tee in a pipe 

Tektronix 4014 

teletype bit 



telldir(S) readdir(S) opendir(S) 

tefflpnam(S) create a name for a temporary 

temporary file 

temporary file 



termcap to terminfo deacription 

termcap(M) terminal capability databaae 

terminal capability databaae 

terminal capability database 

terminal 

terminal 

terminal Interface 

terminal line connection 

terminal management 

terminal mesg(C) 

terminal mode 

terminal modea 



terminal acreen 

terminal acreen handling and 
terminal session 



terminal aettiaga uaed by getty 
terminal 



3l>eed, line 



terminal to print screen display 

terminal 

teiminal t^e, modea, 

terminala file 

terminals 

teminala 



terminala (H) llat of aupported terminala 
terminate a preceaa 



terminate error-logging demon 

terminate preceaa 

terminate wait(S) 

terminfo database 

terminfo deacription 

terminfo deacriptions 

tarmittfo source 



teminfo(H4 terminal capability databaae 

tcrmio^M) general terminal interface 

teiW(W eonveatienai aamea for terminala 
teams and aymbols 



ctagsCC) 

tail(C) 

8lnh(S) 

trio(S) 

archive (C) 

tapeutil(C) 

dump. hd(C) 

frec(M) 

recover (C) 

reatore.hd(C) 

tapeutil(C) 

tar(C) 

taearch(S) 

tee(C) 

tee(C) 

tk(C) 

reset (C) 

directory(S) 

tmpnam(S) 

tmpfile(S) 

tmpriam(S) 

captoinfo(M) 

termcap (M) 

termcap(M) 

terminfo (H) 

. ct(C) 
ctermid(S) 
termio(H) 

. dial(S) 

. vt(M) 
mesg(C) 
Betty(M) 
tset(C) 

. clear (C) 
curses (S) 
script (C) 
gettydefs(M) 
taba(C) 
psereen(C) 
ttynameCS) 
uugetty(N) 

. ttys(M) 
terminala (M) 

. term(M) 
terminals (M) 

, klll(C) 
erratop(C) 
exit(S) 

, wait(S) 
tput(C) 
oaptoinfo(M) 
infocmp(M) 

, tic(C) 
terminfo(H) 
termio(M) 
term(M) 
glossary (C) 
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isnan(S) ianantiS) isnand(S) test for floating point NaN 



ed(C) red(C) Invoke the ed 
edlt(C) Invoke the edit 
ex(C) invoke a 
diff(C) conpare two 
fspec(F) format specification in 
fmt(C) simple 
plock(S) lock process, 
binary search trees tsearch(S) 



clock (H) provide access to the 
cron(C) execute commands at specified 

touch(C) update access and modification 
times (S) get process and child process 
set file access and modification 
times 



temporary file 
characters conv(S) toupper(S) 
popen(S) pclose(S) Initiate pipe 
conv(S) toupper(S) toascil(S) 
chkshlib(CP) 
tsort(C) sort a file 
times of a file 
translate characters conv(S) 
query terrainfo database 

strace(H) print STREAMS 
ptrace(S) process 
aftp(C) 

conv(S) toupper(S) toascii(S) tolower(S) 

tr(C) 
xpd(M) 
uucico(M) file 
uusched(M) scheduler for the uucp file 

ftw(S) walk a file 
tdelete(S) twalk(S) manage binary search 
trig(S) atanCS) atan2(S) 
sin(S) cos(S) tan(S) asin(S) acos(S) 
functions 

acos(S) trigonosmtrlc functions 
manage binary search trees 



setmoden(C) set up 
makettys(M) create 



terminal 

file of the current user 



test(C) evaluate an expression 

text editor 

text editor 

text editor 

text files 

text files 

text formatter 



text, or data in memory 

tfind(S) tdelete(S) twalk(S) manage 

tlc(C) compile termlnfo source 

time(C) time a comnand 

time-of-day chip 

times 

tlme(S) get time 

times of a file 

times 



times utime(S) 

times (S) get process and child process _ 
tlmezone(H) set default system time zone 

tk(C) paglnator for Tektronix 4014 

tmpfile(S) create a temporary file 



tmpnam(S) tempnam(S) create a name for a 

toaacil(S) tolower(S) translate 

to/ from a process 



tolower(S) translate characters 

tool for comparing shared libraries 
topologlcally 



isnan ( S ) 
test(C) 

ed(C) 

edit(C) 

ex(C) 

diff (C) 

fspec(F) 

fmt (C) 

plock(S) 

tsearch(S) 

tlc(C) 

tlme(C) 

clock (M) 

cron(C) 

time(S) 

touch(C) 

times (S) 

utime(S) 

times(S) 

timezone(M) 

tk(C) 

tmpfile(S) 

tmpnam(S) 

conv(S) 

popen(S) 

conv(S) 

chkBhlib(CP) 

tsort(C) 



touch(C) update access and modification _ touch(C) 

toupper(S) toascii(S) tolower(S) 

tput(C) 



tra(C) copy out a file as it grows 

trace messages 

trace 

transfer files between Altos machines 

translate characters 

translate characters 



transparent printer daemon 

transport program for uucp system 
transport program 



tr(C) translate characters 
tree 



trees tsearch(S) tflnd(S) 
trigonometric functions _ 



trigonometric functions trig(S) 

trig(S) atan(S) atan2(S) trigonometric 

trig(S) sin(S) cos(S) tan(S) asin(S) 

true(C) return with a zero exit value 

tsearch(S) tfind(S) tdelete(S) twalk(S) 
taet(C) set terminal modes 



taort(C) sort a file topologlcally 

tty port for a modem 

tty special files 



tty(C) get the current port name 

ttyname(S) isatty(S) find name of a _ 
ttyslot(S) find the slot in the utmp 
ttys(M) login terminals file 



oonv ( S ) 
tput(C) 
tra(C) 
strace(M) 
ptrace(S) 
aftp(C) 
conv ( S ) 
tr(C) 
xpd(H) 
uuclco(M) 
uusched(M) 
. tr(C) 
ftw(S) 
tsearch(S) 
trig(S) 
. trlg(S) 
, trig(S) 
. trig(S) 
true(C) 
tsearch(S) 
. tset(C) 
tsort(C) 
setmodem(C) 
makettys(M) 
. tty(C) 
ttyname(S) 
ttyalot(S) 
ttys(M) 
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tsearch(S) tfind(S) td«lete(S) 
dtype(C) determine disk 
flle(C) determine file 
Byafs(S) get file system 
au9etty(M) set terminal 
types (F) primitive system data 

date aitd time to string ctime(S) 



getpw(S) get 



systems raountalKO 
mount (C) 
iivfofmation 

uniget(CP) 
file 
stream 

mktemp(S) make a 
cena-tants 
units (C) convert 

uname(C) print the current 
cu(C) call another 
glossaryCO define common 
uulog(C) uuname(C) copy files from 
uuname(C) copy files from UNIX to 
uux(C) execute comaiand on remote 
uute(C) uupick(C) public 
linkm unlink(-H) link and 
(^rectories link(M) 

packtC) pcat(G) 
pause (S>) suspend process 
a tile touah<-C) 
programs Rake(C) maintais. 
laearch(S) Ifind(S) linear search and 
sync(S) 
sync(C) 
uparada.hd(C) 
disk 
shutyp«(M) 
shttttYP«(S) get and set 
li»t(CP) cheek C language 
du(G) stinawrize disk 
su(C) make the 
ua(C) 
id(C) print 
setuid(S) set 
crontab(C) manage 
get character login name of the 
environ (H) 

Hhoami(C) print effective current 



twalk(S) manage binary search trees 

type 

type 

type information 

type, modes, speed, line discipline 

types 

types ^F) primitive system date types 
tz*et(-S) asctime(S) cftlme(9) convert 

ua(^C) ueer administration program 

'Uadm<l.n(S) administrative control 

UID 



ulimit(S) get and set user limits 



uma8k(C) set file-creation mode mask 

uiii«k(S>) set and get file creation mask 
unountalKG) maunt/unmeunt multiple file 
umeut>t(C) meunt /unmount a file structure 
uname(C) print the current UNIX 



uname(S) get name o'f current UNIX system 

undo a previous get of an SCCS file 

un9et(CP) usde a previous get of an SCCS 
ungate (S-) push character back into input 
uniq(C) report repeated lines in a file 
unique file name 



unifStd(F) fll* header for symbolic 

units 

units (C) convert units 

UNIX information 

UNIX system 



UNIX terms and symbols 
UNIX to UNIX uucp(C) _ 
UNIX uucp(C) uulog(C) 
UNIX 



BNIX-to-UHIX syaten file copy 

unlink files and directories 

UDllnk(M) link and unlink files and 
unlink (S) remove directory entry 



uopaGk(C) oeaqpresa and expand tiles 
until signal 



updat* accass and Modification tines of 

update, and regenerate groups of 

update 

update super block 

update the super-block 

upgrade an additional hard disk 

upgrade. hd(C) upgrade an additional hard 

UPS shutdown configuration utility 

UPS shutdown limits 

usage and syntax 

usage 

user a super-user or another user 

user adad.nlstratlon program 

user and group ID and names 

user and group IDs 

user crontab files 

user cuserid(S) 

user environment 

user id 



tsearch(S) 

dtype(C) 

tile(C) 

aysfs(S) 

uugetty (M) 

types(F) 

types (F) 

ctime(S) 

ua(C) 

uadfflin ( S ) 

getpw(S) 

ulimit(S) 

umask(C) 

umask ( S ) 

mountall (C) 

mount (C) 

uname(C) 

unaffle(S) 

unget(CP) 

unget(CP) 

ungetc(S) 

uniq(C) 

mktemp(S) 

unistd(F) 

units(C) 

units(C) 

uname(C) 

cu(C) 

glossary(C) 

uucp(C) 

uucp(C) 

uux(C) 

uuto(C) 

link(n) 

link(H) 

unlink(S) 

pack(C) 

pause ( S ) 

touch (C) 

make(C) 

laearch(S) 

sync(S) 

sync(C) 

upgrade. hd(C) 

upgrade. hd(C) 

shutype(H) 

shuttype(S) 
. lint (CP) 
. du(C) 
. su(C) 
. ua(C) 
. ia(C) 

8etuid(S) 

crontab (C) 

cuserid(S) 

environ(H) 

whoami(C) 
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newgrp(C) log 
uliiiilt(S) get and set 
last(C) print last record of 
lognaine(S) return login name of 
getuid(S) getegid(S) get real/effective 
getuld(S) geteuld(S) get real/effective 
getuld(S) getgld(S) get real/effective 
make the user a super-user or another 
the slot In the utmp file of the current 
wrlte(C) write to another 
get and set Riaximum number of 
flnger(C) find information about 
wall(C) write to all 
fuser(M) identify processes 
egrep(C) search file for pattern 

cpset (C) install 
drive tapeutil(C) 
setmode(C) printer modes 
shutype(M) UPS shutdown configuration 
modification times 
utmp(M) wtmp(H) format of 
utmpnaffle(S) endutent(S) access 
getut(S) setutent(S) getutline(S) access 
ttyslot(S) find the slot in the 
entries 

entry getut(S) getutent(S) 
and permissions file 
UUCP system 
cleanup 
uucheck(H) check the 
uusched(H) scheduler for the 
mail from 
uucleanup(H) 
uustat(C) 

uucico(H) file transport program for 
from UNIX to UNIX 
speed, line discipline 
to UNIX uucp(C) 
uucp(C) uulog(C) 
file copy uuto(C) 
transport program 
control 
system file copy 
debugging on 



val(CP) 

abs(S) return integer absolute 
false (C) return with a nonzero exit 
getenv(S) return 
fabs(S) floor, ceiling, and absolute 
fmod(S) floor, ceiling, and absolute 
putenv(S) change or add 
true(C) return with a zero exit 
values (F) machine-dependent 



user into a new group 

user limits 

user logins 

user 



user or group IDs 
user or group IDs 
user or group IDs 
user su(C) 



user ttyslot(S) find 
user 



users allowed to log in numusers(S) 
users 



using a file or file structure 
using full regular expression 



ustat(S) get file system statistics 

utilities 



utility program for a streaming tape 

utility 

utility 

utime(S) set file access and 

utmp and wtmp entries 



utmp file entry getut(S) getutent(S) 
utmp file entry 



utmp file of the current user 

utmp(N) wtmp(N) format of utmp and wtmp 
utmpname(S) endutent(S) access utmp file 

uucheck(M) check the uucp directories 

uucico(H) file transport program for 

uucleanup(M) uucp spool directory 



newgrp(C) 

ulimit(S) 

last(C) 

logname ( S ) 

getuid(S) 

getuid(S) 

getuid(S) 

su(C) 

ttyslot(S) 

write(C) 

numusers ( S ) 

finger (C) 

walKC) 

fuser(N) 

egrep(C) 

ustat(S) 

cpset (C) 

tapeutll(C) 

setmode(C) 

shutype(M) 

utime(S) 

utmp(M) 

getut(S) 

getut(S) 

ttyslot(S) 

utmp(N) 

getut(S) 

uucheck(M) 

uucico(M) 

uucleanup(M) 



UUCP directories and permissions file uucheck(M) 

UUCP file transport program 

uucp link rmail(C) receives 

uucp spool directory cleanup 



UUCP status inquiry and job control 
UUCP system 



uu8ched(M) 
rmail(C) 
uucleanup(M) 
uustat (C) 
uucico(H) 
uucp(C) 
uugetty(M) 



uucp(C) uulog(C) uuname(C) copy files 
uugetty(M) set terminal type, modes. 
uulog(C) uuname(C) copy files from UNIX _ uucp(C) 

uuname(C) copy files from UNIX to UNIX uucp(C) 

uupick(C) public UNIX-to-UNIX system uuto(C) 

uusched(H) scheduler for the uucp file uusched(H) 

uustat (C) uucp status inquiry and job uustat (C) 



uuto(C) uupick(C) public UNIX-to-UNIX 

uutry(H) contact remote system with 

uux(C) execute command on remote UNIX 

uuxqt (H) execute remote comnand requests 

val(CP) validate an SCCS file 

validate an SCCS tile 

value 

value 

value for environment name 

value functions floor(S) ceil(S) 

value functions floor (S) 

value to environment 

value 

values 



uuto(C) 

uutry{M) 

uux(C) 

uuxqt (H ) 

val(CP) 

val(CP) 

abs(S) 

false (C) 

getenv(S) 

floor (S) 

floorCS) 

putenv(S) 

true(C) 

values (F) 
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vsprintf(S) print formatted output of 
list 

varargs ( F ) handles 

get option letter from argument 
assert (S) 

vc(CP) 
get (CP) get a 
scc8dlff(CP) compare two 
output of varargs list vprlntf(S) 
editor 
more(C) 

with label checking 
f llesystem(M) format of a system 
formatted output of varargs list 
varargs list vprlntf(S) vfprintf(S) 
virtual terminal management 
resource waltsem<S) nbwaitsem(S) 
wait(C) 
terminate wait(S) 
processes 
or terminate 
access to semaphore resource 
ftw(S) 



manual for program 



users 

fold(C) fold long lines for finite 
prof(F) profile 
fgetc(S) getchar(S) get character or 
putw(S) fputc(S) put character or 
wc(C) count lines. 
cd(C) change 
chdir(S> change 
getcwd(S) get path name of current 
pwd(C) print 
«nrite(S) 
putpwent (S) 
wall(C) 
write(C) 



open(S) open for reading or 
drive(C) drive information 
utmp(H) wtrap(M) format of utmp and 
utmp(N) 



values(F) machine-dependent values 
varargs list vprintf(S) vfprintf(S) 



values (F) 

vprlntf (S) 
varargstF) 
varargs (F) 
vc(CP) 
getopt(S) 
assert (S) 
vc(CP) 
get (CP) 
sccsdiff(CP) 

vfprintf (S) vsprintf(S) print formatted _ vprlntf(S) 

vi(C) invoke a screen-oriented display vi(C) 

view a file one full screen at a time more(C) 

virtual terminal management vt(M) 

volcopy(M) 
f ilesy8tem(M) 
vprintf (S) 
vprlntf (S) 
vt(M) 

Haitsem(S) 
walt(C) 
wait(S) 



varargs (F) handles variable argument 

variable argument list 

vc(CP) version control 

vector getopt(S) 

verify program assertion 

version control 

version of an SCCS file 

versions of an SCCS file 



volcopy(M) labelit(M) copy file system 

volume 

vprlntf(S) vfprintf(S) vsprintf(S) print 

vsprintf(S) print formatted output of 

vt(M) 

wait and check access to semaphore 



wait completion of background processes 
wait for child process to stop or 



wait(C) wait completion of background walt(C) 

walt(S) wait for child process to stop wait(S) 

waitsem(S) nbwaitsem(S) wait and check waltsem(S) 

walk a file tree 



wall(C) write to all users 

wc(C) count lines, words, and characters 
what(C) identify files 



ftw(S) 
wall(C) 
wc(C> 
what(C) 

wherels(C) locate source, binary, or wherels(C) 

whoaml(C) print effective current user whoami(C) 

who(C) display who is on the system who(C) 

whodo(M) determine who is doing what whodo(M) 



whom(C) display In columns logged in 

width output device 

within a function 



word from a streaa getc(S) getw(S) 
word on a stream putc(S) putchar(S) 

words, and characters 

working directory 

working directory 

working directory 

working directory name 

write on a file 



write password file entry 

write to all users 

write to another user 



write(C) write to another user 

write (S) write on a file 

writing 



written during manufacturing 
wtmp entries 



whom(C) 

fold(C) 

prof (F) 

getc(S) 

putc(S) 

wc(C) 

cd(C) 

chdlr(S) 

getcwd(S) 

pwd(C) 

write(S) 

putpwent ( S ) 

walKC) 

write(C) 

wrlte(C) 

write{S) 

open(S) 

drive (C) 

utmp(M) 



wtmp(M) format of utmp and wtmp entries _ utmp(M) 
xar(CP) maintain archives and libraries _ xar(CF) 

xar(F) archive file format xar(F) 

xargs(C) construct and execute commands _ xargs(C) 
xcc(CD invoke the XENIX compiler xcc(CP) 
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enrolKC) xsend(C) 
from files 
adb(C) Invoke 

enroll (C) 

bessel(S) jO(S) 

true(C) return with a 
timezone(H) set default system time 



xget(C) secret mail enroll(C) 

xld(CP) invoke the link editor xld(CP) 

xli8t(S) fxllst(S) get name list entries xllst(S) 

xnm(CP) print name list xnm(CP) 

x.out general purpose debugger adb(C) 

xpd(H) transparent printer daemon xpd(M) 

xref(CP) cross-reference C programs xref(CP) 

xsend(C) xget(C) secret mail enroll(C) 

xstr(CP) extract strings from C programs xstr(CP) 

xttY(C) set the options for a port xtty(C) 

yO(S) Bessel functions bessel(S) 

yacc(CP) invoke a compiler-compiler yacc(CP) 

yes(C) print a string repeatedly yes(C) 

zero exit value true(C) 

zone tlmezone(M) 
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Contents 
Commands (C) 



intro 


Introduces operating system commands. 


accept, reject 


Allows/prevents print requests. 


acct 


/-vccouiiLiiig sybteiii. 


adb 


Invokes a general purpose debugger (for x.out 




binaries). 


add.lid 


Adds an additional hard disk. 


aftp 


Transfers files between Altos machines. 


archive 


Saves the contents of a file system to a 




streaming tape drive. 


asa 


Interprets asa carriage control characters. 


asktime 


Sets the system time of day. 


at, batch 


Executes commands at a later time. 


autoreboot 


Automatically reboots the system. 


awk 


Pattern scanning and processing language. 


badblock 


Adds new bad sectors to the bad sector map. 


banner 


Prints large letters. 


basename, 


Delivers portions of pathnames. 


dirname 




be 


Arbitrary-precision arithmetic language. 


bdiff 


Compares files too large for diff. 


bfs 


Scans big files. 


bsh 


Invokes the Business shell. 


cal 


Prints a calendar. 


calendar 


Invokes a reminder service. 


cat 


Concatenates and displays files. 


cd 


Changes working directory. 


chmod 


Changes the access permissions of a file or 




directory. 


chown, chgrp 


Changes owner or group ID. 


chroot 


Changes root directory for command. 


clear 


Clears terminal screen. 


cmp 


Compares two files. 


comm 


Selects or rejects lines common to two sorted 




files. 


copy 


Copies groups of files. 


cp 


Copies files. 


cpio 


Copies file archives in and out. 
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cpset 


Installs utilities. 


cron 


Executes commands at specified times. 


crontab 


Manages user crontab files. 


csh 


Invokes a shell command interpreter with C-like 




S5nitax. 


csplit 


Splits files according to context. 


ct 


Spawns getty to a remote terminal. 


ctags 


Creates a tags file. 


cu 


Calls another UNIX system. 


date 


Prints and sets the date. 


dc 


Invokes an arbitrary precision calculator. 


dd 


Converts and copies a file. 


devinfo 


Displays device information. 


devnm 


Identifies device name on which files reside. 


diff 


Compares two text files. 


diff3 


Compares three files. 


digest 


Creates menu system(s) for the Business Shell. 


dircmp 


Compares directories. 


disable 


Disables logins on a port. 


dos 


Accesses MS-DOS files. 


drive 


Reads drive information written during 




manufacturing. 


dtype 


Determines disk type. 


du 


Summarizes disk usage. 


dump.hd 


Dumps the contents of a hard disk to tape. 


echo 


Echoes arguments. 


ed, red 


Invokes the ed text editor. 


edit 


Invokes the edit text editor (variant of ex). 


egrep 


Searches a file for a pattern using full 




regular expression. 


enable 


Enables logins on a port. 


enroll. 


Secret mail. 


xsenu, xget 




env 


Sets environment for command execution. 


errstop 


Terminates error-logging demon. 


ex 


Invokes a text editor. 


expr 


Evaluates arguments as an expression. 


factor 


Factors a number. 


false 


Returns with a nonzero exit value. 


fcopy 


Copies a floppy diskette. 


fdisk 


Maintains disk partitions. 


fgrep 


Searches a file for a character string. 


file 


Determines file type. 


find 


Finds files. 
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finger 


Finds information about users. 


fleece 


Looks for files in home directories. 


fmt 


Simple text formatter. 


iOlU 


r UiU XUIlg ililoo iUX 1 Xlli W ILL til UU tpu U V lUt^ • 


loriiidi. 


ruixuciLb ci iiuppy uiontJULt;. 


from 


T ic'f'c xx/Hrv TnT7 mail ic "fTT^m 

IjIoLo WliLI lliy ILLCiiL io liUiXi* 






getopt 


Parses command options. 


gets 


Lj6ts a String ironi tiie staiiuaru input. 


glossary 


jjerines conuiion uinia terins auu syiiiuois. 


graph 


J-TaWb d- giapiU 


grep 


oearcnes a iiie lor a paLLern. 




r^loQAQ Aiil" fhp "flip QVQl'pm<i i^TiH TiP^l't'Q fhp PPT T 


hd 


Displays files in hexadecimal format. 


hdr 


Displays selected parts of an object file. 


ilt^Clvi 


XT 1 llltD LXXt^ XIX Xt^W XXlXc^o UX d otX t:;ciXXi* 




v/pcxduxxxg oyoLCXxx xxcxp xdi^xxxty* 




r^XXLv?Xo XXXc^o XUX pXXXlLXXX^ vIXX dXX Xxir XjdoC'XJt^L 




pi xxxtt^r* 


id 


Prints user and group ID and names. 


ipcrm 


Removes a message queue, semphore set, or 




shared memory id. 




T?Pr\r^'rf"c inl'P'r— T^rr\r*pcc cf\mvnitT\]r*^i'\r\T\ "Fji/^i]i1"ipg 

XXCJ^VJX XXX L\7i ^X L/L.'C^OO V^v^XXXlilLXXiX^d LXv^Xi Xdv^XXX UXCD 




status. 


join 


JUilia UWU icidLiUiib. 


Kill 


1 erminates a process. 


Kiiiaii 


Kills all active processes. 


laUcllL 


irrovicico iducio iur iiie ayoLciiib. 


Incf 
IdbL 


r^llllLo IcioL XcCUltl Ui Uocl allU. LtJlctypc lUglllb. 


leave 


Reminds you when you have to leave. 


line 


KGdQS one xxne ox xnput. 


In 

111 


IV/Tcil/'^io 51 linlr i"/^ n "Flip 
iVlciKtJb d XXXiJv tU d XXXtr. 


login 


OXVCo yUU LLI LlXt? oy b tcxxx. 


logname 


oe ts logxn ndixit^ • 




PinHc: linpc: in n c:nr1"p{i li^l" 

XT XIXVXo IXiiC^o Xi.1 d ov/1 u^vx xxou* 


Ip, cancel 


Sends/cancels requests to LP line printer. 


Ipenable, 


Enables/disables LP line printers. 


Ipdisable 




Ipr 


Routes named files to printer spooler. 


Ipstat 


Prints LP status information. 
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Is Gives information about contents of 
directories. 

mail System mail. 

make Maintains, updates, and regenerates groups of 
programs. 

mesg Allows or disallows messages sent to a 
terminal. 

mkdir Makes a directory, 

mknod Builds special files. 

mkstr Creates an error message file from C source, 

more Views a file one full screen at a time, 
mount, umount Mounts/unmounts a file structure, 

mountall, Mounts/unmounts multiple file systems, 
umountall 

multiuser, Brings system up in multi-user /single-user 

singleuser mode, 

mv Moves or renames files and directories. 

nawk Pattern scanning and processing language. 

newgrp Logs user into a new group. 

nice Runs a command at a different priority. 

nl Adds line numbers to a file. 

nohup Runs a command immune to hangups and quits. 

num Numbers lines. 

od Displays files in octal format. 

pack, peat, Compresses and expands files, 
unpack 

passwd Changes login password. 

pconfig Sets the port configuration. 

pg File perusal filter for CRTs. 

pr Prints files on the standard output. 

printenv Prints out the environment. 

ps Reports process status. 

pscreen Sets up terminal to print screen display. 

pwd Prints working directory name. 

quot Summarizes file system ownership. 

random Generates a random number. 

reboot Automatically reboots the system. 

recover Restores the contents of a file system from 

streaming tape to disk, 

reset Resets the teletjTpe bits, 

restore.hd Restores a hard disk from tape. 
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lev 




rm rmHir 

JL lily J. XilviXl 


J.\.V/lllv/ V VirO i. XXV^O yjX VJ.±X ^\_' L'\JX l^O* 


riii3il 


"PpppiTTpc; TTij^il ( from nnr*r> litilc^ 


Ilk sar 


Sv^tpm Pipfivitv rpnnrfpr 


^ qrriDt 


AA?ilrPc ^ TP/^OTrl r^f TrniTT ■f'Pfmi'nsil cpccirin 

iVlClxV.Co d i CC'Lli <J. V^l yULli Lv^llililiCli oCoolvJll* 


sdb 


^■\7mhol i p riphi i P'O'pr 


sdiff 


r^omnA^rpQ "f iIpq qiHp— Hv— ciiHp 


SGd 


TnvnlcpQ fhp ^trp^^m pHifni" 

X 11 V \JZ\.\^0 Ullv^ O ^dlll ^V_1X L'\JX • 




T^iC'nli^x/c 51 "Flip 


Liilll L 


XZib LclUXXMit;^ / C^LC/ liUXtLciU LclUXt;?* 




T^ori* TnoH pQ 1 1 1 1 1 f\7 

JT L/J- U iil\J\J.CO IXUXXXL^* 


RPfTTlodPTTl 


Spt«5 iiD ttv Dort for ii«;p with ?i mndpm 

k-/^UO »^ V u ^^Vyi U XV/1 WXUll Ci 111\^V4.\I^111* 




T7vPPn1"Pc ?i Pornmj^'nH in tipix/ ■nr/^/^Pcc orTr\iTr4 

XZiA.vri_/U. LCrO d ^vliiXLlIdxiVX Xli d IXC? W jJx VJOCoo ^X VJIX^* 




V_ylidIXgCo Lilc::; dv^Cv^oo dilU lli^U.XXXL.'dLXLlXX UdLc^o UX 




files* 


tjXX^ X oil 


Tnvokpc: thp ^hpl 1 pommPinri intprnrpfpr 

XllVVyxV^O Cll^ OllV'XX v^\m/X11XX1CXXXVX XXX Cvi/X Lyx ^ u^x • 


shl 


Shpll l^ivpr m?^Ti?^ffpr 

(■^llv.'XX XCl V ^X lllCillCigV^X • 


size 


Print*? <?ppt ion ^i7p<; of pomTTinn ohippt f ilp9 

X X XXX irO O^^L'XVXX JXJLiK^iD \J1. v^V/XXXllXv/XX VI^Jv^v^L- XXXv^O* 


sizefs 


Determines the size of 3. logical disk drive. 


sleep 


^iiQOpnrlQ pvppiit ion "for ?^n intprvj^l 

O U.O|;^v?XXU.o C>A.C^l^U. L-XL/XX XvIX CIXX XXxLC^X VdX* 


sort 


Sorts and merges files* 


spell 


Finds *^r)pllinff prrnr<5 

X. XllVJlO OJw/V^XXXXXg V'X X \JX o* 


S <;nlinp 


TntpTDolptpQ <?mooth pnrvpc: 

XXX L'^X ^VyXd OlXX^^V^ 1..11 v^/LiX V v^o* 


cinl it 


Q'nlitc ?i "flip intr> TiiP/^PC 

OjJXXLo d XXXc? XXX JJXC^OC'O* 


ssp 


T^PTTiOTZPC i^r^ncppntiTrp Hl^inlr Iiupc 

XvCXXXvJVCo v^lJXXoCI-'U. LX VC UXdXXiY XXilC'O* 


strings 


Finds the printable strings in an object file. 


sttv 


Sets thp ODtions for nort 

k^V^UO Ullv^ \fX\JXXtJ XVyX ex ^\JX l^m 


su 


Makes the user a super-user or another user. 


sum 


Calculates checksum and counts blocks in a 




f ilp 

XXXc!. 




v^XldllgtJo oWdp UCVXCc UUXlXXgliXdtlUll. 








oe Lb by b Leiii coiix xgurd Lion imoruid Lion. 




Ot^L LdUb UxX d tc;X lilXXidX. 


tail 


T^pliTZPTC thp Ij^ct T^j^rt rvF a "Filo 

X-/CJXXVCXO LXXc? XdbL ^dX L KJx d IXXc^. 




u LxxxLy u^x dxxx lkjl d b lx c^diiixiig LdjJt; cii xvt?. 


tar 


ArphivpQ f ilpQ 

xxL V>'X1X V Vi^O XXX^O. 


tee 


f^l*P5l tPC 51 tpP in 55 T\1F\P 

v^x Lc^o d tC'V? XXX d |JXjj\:;. 




T7T75>lii5S't"po 55 n PYTM*PCCir%n 
x!tVdXu.dLc;b dxi t;A|^x t^bbXwXx. 


tic 


Compiles terminfo source. 


1 time 


Times a command. 


' tk 


Paginator for Tektronix 4014. 


touch 


Updates access and modification times of a 




file. 


tput 


Queries terminfo database. 
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tr Translates characters. 

tra Copies out a file as it grows. 

true Returns with a zero ("true") exit value. 

tset Sets terminal modes. 

tsort Sorts a file topologically. 

tty Gets the current port name. 

ua User Administration program, 

umask Sets file-creation mode mask, 

uname Displays the current operating system 
information. 

uniq Reports repeated lines in a file, 

units Converts units, 

upgrade.hd Upgrades an additional hard disk. 

UUCP, uulog, Copies files from UNIX to UNIX, 
uuname 

uustat Uucp status inquiry and job control, 

uuto, uupick Public UNIX-to-UNIX system file copy, 

uux Executes command on remote UNIX. 

vi Invokes a screen-oriented display editor. 

wait Awaits completion of background processes, 

wall Writes to all users, 

wc Counts lines, words, and characters, 

what Identifies files. 

whereis Locates source, binary, or manual for program, 

who Displays who is on the system, 

whoami Prints effective current user id. 

whom Columnar display of system users, 

write Writes to another user. 

xargs Constructs and executes commands, 

xtty Sets the options for a port. 

yes Prints a string repeatedly. 
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Name 

intro - Introduces operating system commands. 



Description 



This section describes use of the commands available in 
the Run-time System. Unless otherwise noted, conmiands 
described in this section accept options and other argu- 
ments according to the following syntax: 

name [ option... ] [ cmdarg... ] 

where: 



name Is the name of an executable file. 

option Is -noargletter(s) or, -argletterOoptarg (<> 
is optional whitespace). 

noargletter Is a single letter representing 

an option without an argument. 

argletter Is a single letter representing 

an option requiring an argument. 

optarg Is an argument (character 

string) satisfying the preceding 
argletter. 

cmdarg Is a pathname (or other command argument) not 
beginning with -. By itself, - indicates the 
standard input. 



Command Syntax Standard: Rules 

These command syntax rules are not followed by all current 
commands, but all new commands will obey them. 
Getopts(C) should be used by all shell procedures to parse 
positional parameters and to check for legal options. It 
supports Rules 3-10 below. The enforcement of the other 
rules must be done by the conmiand itself. 
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1. Command names {name above) must be between two 
and nine characters long. 

2. Command names must include only lower-case letters 
and digits. 

3. Option names {option above) must be one character 
long. 

4. All options must be preceded by 

5. Options with no arguments may be grouped after a 
single 

6. The first option-argument {optarg above) following an 
option must be preceded by white space. 

7. Option-arguments cannot be optional. 

8. Groups of option-arguments following an option must 
either be separated by commas or separated by white 
space and quoted (e.g., -o xxx,z,yy or -o "xxx z yy"). 

9. All options must precede operands {cmdarg above) on 
the command line. 

10. "~" may be used to indicate the end of the options. 

11. The order of the options relative to one another 
should not matter. 

12. The relative order of the operands {cmdarg above) 
may affect their significance in ways determined by 
the command with which they appear. 

13. "-" preceded and followed by white space should only 
be used to mean standard input. 



See Also 

getopts(C), getopt(S) 
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Diagnostics 

Upon termination, each command returns 2 bytes of status, 
one supplied by the system and giving the cause for ter- 
mination, and (in the case of "normal" termination) one 
supplied by the program (see wait(S) and exit(S)). The 
former byte is 0 for normal termination; the latter is 
customarily 0 for successful execution and nonzero to in- 
dicate troubles such as erroneous parameters, bad or in- 
accessible data. It is called variously "exit code," 
"exit status," or "return code," and is described only 
where special conventions are involved. 



Notes 

Not all commands adhere to the syntax described here. 
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Name 

accept, reject - Allows/prevents print requests to a line- 
printer or class of printers. 



Syntax 

/usr/lib/accept destination... 

/usr/lib/reject [ -r [ reason ] ] destination... 



Description 

Accept allows lp(C) to accept requests for the named des- 
tinations. A destination can be either a printer or a 
class of printers. Use Ipstat(C) to find the status of 
destinations. 

Reject prevents lp(C) from accepting requests for the 
named destinations. A destination can be either a printer 
or a class of printers. Use Ipstat(C) to find the status 
of destinations. 

These commands can only be used by the super-user. 

You can use the following option with reject: 

-rireason] Associates a reason that prevents Ip from 

accepting requests. This reason applies to 
all printers mentioned up to the next -r 
option. Reason is reported by Ip when 
users direct requests to the named destina- 
tions. Reason is also reported by Ipstat. 
If -r is not present or is given without a 
reason, a default reason will be used. 



Files 

/usr/spool/lp/* 



See Also 

enable(C), lp(C), Ipadmin(M), Ipinit(M), Ipsched(M), 

Ipstat (C) 
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Name 

acct - Accounting system. 



Description 

The accounting system, contained in the directory 
/usr/lib/acct, provides ways to collect per-process re- 
source utilization data, record connect sessions, monitor 
disk use, and charge fees to specific logins. The ac- 
counting system has a set of C language programs and shell 
procedures to reduce the accounting data into summary 
files. 

For a description of the accounting system, see the Opera- 
tions Guide, 



Files 

/usr/lib/acct/* C programs and shell procedures 

to run the accounting system 
/usr/adm/* Active data collection files 

/usr/adm/acct/nite/* Files reused daily by runacct 

/usr/adm/acct/sum/* Cumulative summary files updated 

by runacct 

/usr/adm/acct/fiscal/* Periodic summary files created by 

monacct 



See Also 

/etc/init, /etc/rc2, /etc/wtmp, /usr/lib/cron 
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Name 

adb - Invokes a general-purpose debugger. 



Syntax 

adb [-W ] [ -p prompt ] [ objfile [ corefile ] ] 



Description 

Adb is a general purpose debugging program for use only 
with x.out binaries. Adb may be used to examine files and 
to provide a controlled environment for the execution of 
programs. To debug COFF programs, use sdb(C). 

Ohjfile is normally an executable program file, preferably 
containing a symbol table; if not then the symbolic fea- 
tures of adb cannot be used although the file can still be 
examined. The default for ohjfile is a.out. Corefile is 
assumed to be a core image file produced after executing 
objfile; the default for corefile is core. 

Requests to adb are read from the standard input and re- 
sponses are written to the standard output. The options 
are: 

-w Both objfile and corefile are created if necessary 
and opened for reading and writing so th at files can 
be modified using adb. The B:jllf3i'lf?iiigB key causes 
adb to return to the next command. 

-p Defines the prompt string: any combination of char- 
acters. The default is an asterisk (*). 

In general requests to adb are of the form: 

[address] [, count] [command] [;] 

If address is present, then the current address (dot) is 
set to address. Initially dot is set to 0. For most com- 
mands, count specifies how many times the command will 
be executed. The default count is 1. Address is a spe- 
cial expression having the form: 

[segment:]offset 
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where segment gives the address of a specific text or data 
segment, and offset gives an offset from the beginning of 
that segment. If segment is not given, the last segment 
value given in a command is used. 

The interpretation of an address depends on the context it 
is used in. If a sub-process is being debugged, then ad- 
dresses are interpreted in the usual way in the address 
space of the subprocess. For further details of address 
mapping, see the following section, "Addresses." 



Expressions 

The value of dot. 

+ The value of dot incremented by the current in- 

crement. 

The value of dot decremented by the current in- 
crement. 

" The last address typed. 

integer An octal number if integer begins with a 0; a 
hexadecimal number if preceded by # or Ox; 
otherwise a decimal number. 

integer, fraction 

A 32-bit floating point number. 

The ASCII value of up to 4 characters. The 
backslash (\) may be used to escape a 

The value of name, which is either a variable 
name or a register name. Adb maintains a num- 
ber of variables (see Variables) named by single 
letters or digits. If name is a register name 
then the value of the register is obtained from 
the system header in corefile. The register 
names are eax, ebx, ecx, edx, edi, esi, ebp, 
esp, efi, eip, cs, ds, es, fs, gs, and ss. The 
name fl refers to the status flags. 



< name 



2 



ADB(C) 



ADB(C) 



symbol A symbol is a sequence of upper or lower case 
letters, underscores or digits, not starting 
with a digit. The value of the sjnnbol is taken 
from the symbol table in ohjfile. An initial 
underscore (_) or tilde character (~) will be 
prepended to symbol if needed. 

_symbol In C, the 'true name' of an external symbol be- 
gins with underscore (_). It may be necessary 
to use this name to distinguish it from internal 
or hidden variables of a program. 

iexp) The value of the expression exp. 



Monadic Operators 

*exp The contents of the location addressed by exp. 

-exp Integer negation. 

~exp Bitwise complement. 

Dyadic Operators 

Dyadic operators are left-associative and are less binding 
than monadic operators. 



el^e2 


Integer addition (+) or subtraction (-). 


el*e2 


Integer multiplication. 


el%e2 


Integer division. 


el&e2 


Bitwise conjunction. 


el\e2 


Bitwise disjunction. 


eVe2 


Remainder after division of el by e2. 


elffe2 


El rounded up to the next multiple of e2. 



3 



ADB(C) 



ADB(C) 



Commands 

Most commands consist of a verb followed by a modifier or 
list of modifiers. The following verbs are available. (The 
commands '?' and '/' may be followed by '*'; see 
"Addresses" following for further details.) 

?/ Locations starting at address in objfile are 

printed according to the format /. 

// Locations starting at address in corefile are 

printed according to the format /. 

=/ The value of address itself is printed in the 

styles indicated by the format /. (For i format 
'?' is printed for the parts of the instruction 
that reference subsequent words.) 

A format consists of one or more characters that specify a 
style of printing. Each format character may be preceded 
by a decimal integer that is a repeat count for the format 
character. While stepping through a format, dot is incre- 
mented temporarily by the amount given for each format 
letter. If no format is given, the last format is used. 
The format letters available are: 



o 


2 


Prints 1 word in octal. All octal numbers 






output by adb are preceded by 0. 


O 


4 


Prints 2 words in octal. 


q 


2 


Prints in signed octal. 


Q 


4 


Prints long signed octal. 


d 


2 


Prints in decimal. 


D 


4 


Prints long decimal. 


X 


2 


Prints 1 word in hexadecimal. 


X 


4 


Prints 2 words in hexadecimal. 


u 


2 


Prints as an unsigned decimal number. 


U 


4 


Prints long unsigned decimal. 


f 


4 


Prints the 32-bit value as a floating point 






number. 


F 


8 


Prints double floating point. 


b 


1 


Prints the addressed byte in octal. 


c 


1 


Prints the addressed character. 


C 


1 


Prints the addressed character using the 



following escape convention. Character values 
000 to 040 are printed as an at-sign (@) fol- 
lowed by the corresponding character in the oc- 
tal range 0100 to 0140. The at-sign character 
itself is printed as @@. 
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s n Prints the addressed characters until a zero 

character is reached. 
S n Prints a string using the at-sign (@) escape 

convention. Here n is the length of the string 

including its zero terminator. 
Y 4 Prints 4 bytes in date format (see ctime(S)). 
i n Prints as machine instructions. N is the number 

of bytes occupied by the instruction. This 

style of printing causes variables 1 and 2 to 

be set to the offset parts of the source and 

destination respectively, 
a 0 Prints the value of dot in symbolic form. 

Symbols are checked to ensure that they have 

an appropriate type as indicated below: 
/ local or global data symbol 
? local or global text symbol 
local or global absolute symbol 
A 0 Prints the value of dot in absolute form, 
p 2 Prints the addressed value in symbolic form 

using the same rules for symbol lookup as a. 
t 0 When preceded by an integer, tabs to the next 

appropriate tab stop. For example, 8t moves to 

the next 8-space tab stop, 
r 0 Prints a space, 
n 0 Prints a newline. 

0 Prints the enclosed string. 

Decrements dot by the current increment. 

Nothing is printed. 
+ Increments dot by 1. Nothing is printed. 

Decrements dot by 1. Nothing is printed. 



Available commands include: 

newline If the previous command temporarily incremented 
dot, makes the increment permanent. Repeats 
the previous command with a count of 1. 

[?/][Ll] value mask 

Words starting at dot are masked with mask and 
compared with value until a match is found. If 
L is used, then the match is for 4 bytes at a 
time instead of 2. If no match is found then 
dot is unchanged; otherwise dot is set to the 
matched location. If mask is omitted, then -1 
is used. If a question mark (?) is given, a 
text segment is affected; if a slash (/), a data 
segment. 
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[?/][Ww] Ddue ... 

Writes the 2-byte value into the addressed loca- 
tion. If the command is W, writes 4 bytes. Odd 
addresses are not allowed when writing to the 
subprocess address space. If a question mark 
(?) is given, a text segment is affected; if a 
slash (/), a data segment. 

[?/][Mra] segnum fpos size 

Sets new values for the given segment's file 
position and size. If size is not given, then 
only the file position is changed. The segnum 
must the segment number of a segment already in 
the memory map (see "Addresses"). If a question 
mark (?) is given, a text segment is affected; 
if a slash (/), a data segment. 

Dot is assigned to the variable or register 
named. 

A shell is called to read the rest of the line 
following 'I'. 



>name 
f 



$modifier 

Miscellaneous commands. The available modifiers 
are: 

</ Reads commands from the file / and returns. 

>/ Sends output to the file /, which is 
created if it does not exist. 

r Prints the general registers and the in- 
struction addressed by ip. Dot is set to 
ip. 

f Prints the floating registers in single or 
double length. 

b Prints all breakpoints and their associated 
. counts and commands. 
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c C stack backtrace. If address is given, it 
is taken as the address of the current 
frame (instead of bp). If C is used then 
the names and (16-bit) values of all auto- 
matic and static variables are printed for 
each active function. If count is given 
then only the first count frames are 
printed. 

e Prints the names and values of external 
variables. 

w Sets the page width for output to address 
(default 80). 

s Sets the limit for sjnnbol matches to ad- 
dress (default 255). 

o Sets input and output default format to 
octal. 

d Sets input and output default format to 
decimal. 

X Sets input and output default format to 
hexadecimal. 

q Exits from adb. 

V Prints all non-zero variables in octal, 
m Prints the address map. 



•.modifier 

Manage a subprocess. Available modifiers are: 

brc Sets a breakpoint at address; breakpoint is 
executed count-l times before causing a 
stop. Each time the breakpoint is encoun- 
tered the command c is executed. If this 
command sets dot to zero then the break- 
point causes a stop. 
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dl Delete a breakpoint at address. 

r [arguments] 

Runs objfile as a subprocess. If address 
is given explicitly then the program is 
entered at this point; otherwise the pro- 
gram is entered at its standard entry 
point. Count specifies how many break- 
points are to be ignored before stopping. 
Arguments to the subprocess may be supplied 
on the same line as the command. An argu- 
ment starting with < or > causes the stan- 
dard input or output to be established for 
the command. All signals are turned on on 
entry to the subprocess. 

R [arguments] 

Same as the r command except that 
arguments are passed through a shell before 
being passed to the program. This means 
shell metacharacters can be used in file- 
names. 

cos The subprocess is continued and signal s is 
passed to it (see slgnal(S)). If address 
is given, then subprocess is continued at 
this address. If no signal is specified, 
then the signal that caused the subprocess 
to stop is sent. Breakpoint skipping is 
the same as for r. 

ss As for CO except that the subprocess is 
single-stepped count times. If there is no 
current subprocess, then objfile is run as 
a subprocess as for r. In this case no 
signal can be sent; the remainder of the 
line is treated as arguments to the sub- 
process. 

k The current subprocess, if any, is ter- 
minated. 
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Variables 

Adb provides a number of variables. Named variables are 
set initially by adb but are not used subsequently. Num- 
bered variables are reserved for communication as follows: 

0 The last value printed 

1 The last offset part of an instruction source 

2 The previous value of variable 1 

On entry the following are set from the system header in 
the corefile. If corefile does not appear to be a core 



file 


then 


these values are set from objfile: 


b 


The 


base address of the data segment. 


d 


The 


data segment size. 


e 


The 


entry point. 


m 


The 


execution type. 


n 


The 


number of segments. 


s 


The 


stack segment size. 


t 


The 


text segment size. 



Addresses 

Addresses in adb refer to either a location in a file or 
in actual memory. When there is no current process in 
memory, adb addresses are computed as file locations, and 
requested text and data are read from the objfile and 
corefile files. When there is a process, such as after a 
:r command, addresses are computed as actual memory loca- 
tions. 

All text and data segments in a program have associated 
memory map entries. Each entry has a unique segment num- 
ber. In addition, each entry has the file position of 
that segment's first byte, and the physical size of the 
segment in the file. When a process is running, a 
segment's entry has a virtual size which defines the size 



9 



ADB(C) 



ADB(C) 



of the segment in memory at the current time. This size 
can change during execution. 

When an address is given and no process is running, the 
file location corresponding to the address is calculated 
as: 

effective-file-address = file-position + offset 

If a process is running, the memory location is simply the 
offset in the given segment. These addresses are valid if 
and only if: 

0 <= offset <= size 

where size is physical size for file locations and virtual 
size for memory locations. Otherwise, the requested ad- 
dress is not legal. 

The initial setting of both mappings is suitable for nor- 
mal a.out and core files. If either file is not of the 
kind expected then, for that file, file position is set to 
0, and size is set to the maximum file size. In this way, 
the whole file can be examined with no address transla- 
tion. 

All appropriate values are kept as signed 32-bit integers 
so that adb may be used on large files. 



Files 

/dev/swap 

a.out 

core 



See Also 

ptrace(S), a.out(F), core(F) in the Reference (CP, S, F) 
Programmer's Guide 
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Diagnostics 

The message "adb" appears when there is no current com- 
mand or format. 

Comments appear when there are inaccessible files, sjmtax 
errors, abnormal termination of commands, etc. 

Exit status is 0, unless the last command failed or re- 
turned non-zero status. 



Notes 

A breakpoint set at the entry point is not effective on 
initial entry to the program. 

System calls cannot be single-stepped. 

Local variables whose names are the same as an external 
variable may foul up the accessing of the external. 
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Name 

add.hd - Adds an additional hard disk. 



Syntax 

add.hd [-d] [2] [3] 



Description 

The add.hd command is a shell script that installs an ad- 
ditional hard disk if your system supports more than one 
add-on hard disk. You must be the super-user to use this 
command. 

If you don't specify the number (i.e., 2 or 3) on the com- 
mand line, the script prompts you for the number. Once 
you reply with a correct number, the system installs the 
additional hard disk. 

To safely add (or read) a hard disk, log in as root, and 
follow these steps: 

1. Reboot the system. 

2. Enter system maintenance mode. 

3. Immediately execute add.hd. Do not open the drive 
in any way (e.g., by executing mount, swap, etc.) 
before you add the hard disk. 

Add.hd runs the layout (C) program, which divides the disk 
into the following areas: 

• Spare sectors for bad spots (non-SCSI drives only). 

• File system. 

• Extra swap space. Add.hd asks you if you want a 
swap area on this drive. If you do, answer yes. 
Add.hd will prompt you for the size of the area. If 
you answer no, no swap area is created on the drive. 
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Next the badblock(C) program checks the additional drive 

for bad spots. If there are any, it maps them into the 

spare area. When badblock is finished (takes 15-20 

minut es), you are asked to specify the number of inodes or 

\\ press B'Aiil'tM for the default. 

^ -■■-■<- 

Before the additional hard disk goes to multiuser mode, it 
is checked, and if necessary fsck(C) is run. Then, the 
add-on hard disk is mounted. 

The directory used for the add-on hard disk is /usr2 for 
the second hard disk, /usr3 for the third hard disk. The 
add-on hard disk remains mounted as /usr2 (/usr3) when 
add.hd exits and whenever the system is in multiuser mode. 

-d Non-destructive add. Does not run layout, badblock, 
and mkfs routines. Does not destroy the files on the 
disk. The -d option makes the /usrn directory and 
the necessary devices in /dev, and adds the mount(C) 
command to /etc/fstab, if it does not already exist. 



See Also 

layout(C), make.hd(C), sizefs(C), upgrade.hd(C) 
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Name 



aftp - Transfers files between Altos machines. 



Syntax 



aftp [-f device] [s speed] [file...] 



Description 

The aftp program allows you to transfer files between two 
Altos computer systems. 

The aftp program must be run on both the sending and re- 
ceiving computer. The port that aftp is running on must 
have login disabled (see disable(C)). Either side may be 
started first, but both sides must be started within about 
1 minute of each other. The sending side will output 's' 
every few seconds until communication is established with 
the other side; likewise, the receiving side will output 
'w' every few seconds. During file transfer, aftp will 
output a '*' every time a 128 byte block is successfully 
transmitted, and a '?' every time a block is retransmitted 
to overcome a transmission error. 

For information on setting up your systems see the Opera- 
tions Guide. 



Options 



-f device 



The special file device is used to transfer 
files between the machines. The ports as- 
sociated with the devices on each machine 
should be connected via a null modem cable. 



-s speed 



The transmission rate is set to speed. 
Currently supported speeds are 1200, 2400, 
4800, and 9600 bits per second. The de- 
fault transmission rate is 9600 baud. 
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file On the sending side, file is a file or a 

list of files If file is standard in- 
put is sent. On the receiving side, file 
is an existing directory into which the 
files are received. If file is omitted, 
files are received into the current direc- 
tory. If file is received files are 
written to standard output. 



CP/M and MP/M Systems 

The aftp program is compatible with the ftp program 
available for Altos CP/M and MP/M systems, so files can 
be transferred between CP/M-MP/M systems and UNIX 
systems. Files sent to MP/M and CP/M systems must have 
file names that are legal on those systems. Files sent 
from MP/M and CP/M systems to UNIX systems may end up 
with file names containing and sometimes ending with 
spaces; the UNIX shells can deal with these file names 
if the entire name is enclosed in double quotes. 

Since M P/M and CP/M pad files with Wtl^lAWM (octal 32), 
KttiilWi is deleted from the end of files sent to UNIX 
systems. The files also contain Ctrl-m entries (octal 
15), which need to be stripped out once on the UNIX 
side. For example, 

cat filel I tr -d 'XOIS' > file2 
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Name 

archive - Saves the contents of a file system to a stream- 
ing tape drive. 



Sjmtax 

archive [-A][-e][-i string][-V] file system mag tape device 



Description 

You must be the super-user to use the archive command. 

Use archive to copy the contents of a file system (speci- 
fied by file ^system) to a cartridge tape (specified by 
mag tape), '"if the files will not fit on a single tape, 
you will be prompted to install a new tape. 

The system must be in single-user (maintenance) mode when 
you back up /dev/root. Be sure to specify mag tape device 
as /dev/rsct. If possible, run archive on an unmounted 
file system. 

If you are backing up the first hard disk (/dev/hdOb), use 
the dump.hd(C) command. 



Options 

-A Aborts the backup (at the end of the tape) when a 
write error occurs. 

-e Erases the tape prior to writing data on it. We 

recommend you use the -e option before you back up 
your files. 

-i Puts string (any string up to 128 characters) into 
the header block on the tape. 

-V Verifies that the contents of the tape match the con- 
tents of the disk (bit-for-bit compare). 
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Examples 

This command backs up the first hard disk to tape. 

/etc/dump, hd B'WiliW 

The dump.hd(C) command calls archive, which gives the ap- 
propriate parameters for the first hard disk. 

To restore the first hard disk from tape, boot from the 
diskette labeled "Root File System" and select option c on 
the menu. 

For example, this command backs up the second hard disk to 
tape. 



/etc/umount /dev/hdlb 

archive /dev/rhdlb /dev/rset 



Retn 



Retn 



This command restores the second hard disk from tape. 



/etc/umount /dev/hdlb 

recover /dev/rsct /dev/rhdlb 



Retn 



Retn 



You can check the device name by typing 
mount Brfd4iM 

The screen displays the device name, for example 

/dev/hdib on /usr2 read/write on Mon Mar 31 10; 17: 12 1986 



See Also 



recover(C), dump.hd(C), restore.hd(C) 
Operations Guide 
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Name 

asa - Interprets asa carriage control characters. 



Syntax 

asa [ -s ] [ file ... ] 



Description 

Asa processes the output of Fortran programs that use asa 
carriage control characters. Asa processes the files 
whose names are given as arguments, or standard input if 
no file names are given, and sends the results to the 
standard output. 

The first character of each line is interpreted as an asa 
control character as follows: 

' ' Single space before printing 

'0' Double space before printing 

'-' Triple space before printing 

'r New page before printing 

'+' Overstrike the previous line 

If the first character of a line is not one those listed 
above, it is treated as if it were a space. Asa forces 
the first line of each file to begin on a new page. 

The -s option suppresses error messages from asa. 

Asa returns one of the following values as its exit 
status: 

0 No error 

-1 Output error 

>0 Some input files could not be opened; the 
return code is the total number of files that 
could not be opened. 
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Name 

asktime - Sets the system time of day. 

Syntax 

/etc/asktime 

Description 

The asktime command prompts you for the date: year, 
month, day, and time: hour and minute. This command syn- 
chronizes the real-time clock and the system clock. You 
must be the super-user to use this command. 

Example 

This example sets the new time, date, and year to "9:23 
January 1, 1987". 

Curtent System Tim is Wed Nov 3 X4:3&;23 19^6 
Enter date (yymmda) or pire«9 RETUBN if oK: 870101 
Enter time (hhmm) or press RETUBN if qH; 0923 

See Also 

date(C) 
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Name 

at, batch - Executes commands at a later time. 



Syntax 

at time [ date ] [ + increment ] 

at -r job... 

at -1 [ job... ] 

batch 



Description 

At and batch read conmiands from standard input to be exe- 
cuted at a later time. At allows you to specify when the 
commands should be executed, while jobs queued with batch 
will execute when system load level permits. At may be 
used with the following options: 

-r Removes jobs previously scheduled with at. 

-1 Reports all jobs scheduled for the invoking user. 

Standard output and standard error output are mailed to 
the user unless they are redirected elsewhere. The shell 
environment variables, current directory, umask, and 
ulimit are retained when the commands are executed. Open 
file descriptors, traps, and priority are lost. 

Users are permitted to use at if their name appears in the 
file /usr/lib/cron/at. allow. If that file does not exist, 
the file /usr/lib/cron/at. deny is checked to determine if 
the user should be denied access to at. If neither file 
exists, only root is allowed to submit a job. If at. deny 
is empty, global usage is permitted. The allow/deny files 
consist of one user name per line. These files can only 
be modified by the super-user. 

The time may be specified as 1, 2, or 4 digits. One and 
two digit numbers are taken to be hours, four digits to be 
hours and minutes. The time may alternately be specified 
as two numbers separated by a colon, meaning hour:minute. 
A suffix am or pm may be appended; otherwise a 24-hour 
clock time is understood. The suffix zulu may be used to 
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indicate GMT. The special names noon, midnight, now, and 
next are also recognized. 

An optional date may be specified as either a month name 
followed by a day number (and possibly year number pre- 
ceded by an optional comma) or a day of the week (fully 
spelled or abbreviated to three characters). Two special 
"days," today and tomorrow, are recognized. If no date is 
given, today is assumed if the given hour is greater than 
the current hour, and tomorrow is assumed if it is less. 
If the given month is less than the current month (and no 
year is given), next year is assumed. 

The optional increment is simply a number suffixed by one 
of the following: minutes, hours, days, weeks, months, or 
years. (The singular form is also accepted.) 

at 0815am Jan 24 
at 8:15am Jan 24 
at now + 1 day 
at 5 pm Friday 

At and batch write the job number and schedule time to 
standard error. Batch submits a batch job. It is almost 
equivalent to "at now", but not quite. For one, it goes 
into a different queue. For another, "at now" will re- 
spond with the message "too late." 

At -r removes jobs previously scheduled by at or batch. 
The job number is the number given to you previously by 
the at or batch command. You can also get job numbers by 
typing at -1. You can only remove your own jobs unless 
you are the super-user. 



Examples 

The at and batch commands read from standard input the 
commands to be executed at a later time. Sh(C) provides 
different ways of specifying standard input. Within your 
commands, it may be useful to redirect standard output. 
This sequence can be used at a terminal: 

batch 

sort filename > out file 



Ctrl-d 
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This sequence, which demonstrates redirecting standard 
error to a pipe, is useful in a shell procedure (the se- 
quence of output redirection specifications is significant): 

batch «! 

sort filename 2> &1 > out file \ mail loginid 
I 

To have a job reschedule itself, invoke at from within the 
shell procedure, by including code similar to the follow- 
ing within the shell file: 

echo "sh shellfile" | at 1900 thursday next week 



Files 

/usr/lib/cron 

/usr /lib/cron/at. allow 

/usr /lib/cron/at. deny 

/usr/lib/cron/queuedefs 

/usr/spool/cron/atjobs 



Main cron directory 
List of allowed users 
List of denied users 
Scheduling information 
Spool area 



See Also 

kill(C), mail(C), nice(C), ps(C), sh(C), sort{C), cron(C) 



Diagnostics 



Complains about various sjmtax errors and times out of 
range. 
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Name 

autoreboot - Toggles the autoreboot process on and off. 
(Series 2000 only) 



Syntax 

/etc/autoreboot [on | off] 



Description 

When autoreboot is enabled (on), rebooting the machine 
requires no user input from the console. Thus, the system 
will reboot without the attendance of a system administra- 
tor. Autoreboot off disables the process. 

Autoreboot with no options displays whether the autoreboot 
process is "on" or "off." 

Normally, when the machine is recovering from a system 
crash or a power loss with no UPS installed, the rebooting 
process will invoke fsck(C) (file-system check) which will 
wait for user response. 

Enabling autoreboot causes fsck -y to be run instead, 
which asks no questions. The output of the fsck command 
is saved and mailed to root after the fsck is finished. 
The message "Redirecting fsck output..." is printed when 
the file-system check begins. 
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Name 

awk - Invokes a pattern processing editor. 



Syntax 

awk [-Fc] [-f file] ['prog'] [/ile] 



Description 

The awk command scans each input file for lines that match 
any of a set of patterns specified in prog. With each 
pattern in a program there can be an associated action 
that will be performed when a line of a file matches the 
pattern. The set of patterns may appear literally as 
Vrog, or in a file specified as -f file. The prog string 
should be enclosed in single quotation marks (') to pro- 
tect it from the shell. The -Fc option uses c as a field 
separator. 

Files are read in order; if there are no files, the stan- 
dard input is read. The file name '-' means the standard 
input. Each line is matched against the pattern portion 
of every pattern-action statement; the associated action 
is performed for each matched pattern. 

An input line is made up of fields separated by spaces. 
The fields are denoted $1, $2, ... ; $0 refers to the 
entire line. 

A pattern-action statement has the form: 

pattern {action} 

A missing {action} means print the line; a missing pattern 
always matches. 
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An action is a sequence of statements. A statement can be 
one of the following: 

if {conditional) statement [else statement] 

while (conditional) statement 

for {expression; condition; expression) statement 

break 

continue 

{[statement] ... } 

variable = expression 

print [expression-list] [>expression] 

printf format [, expression-list] [>expression] 

next #skip remaining patterns on this input line 

exit #skip the rest of the input 

Statements are terminated by semicolons, newlines or right 
braces. An empty expression-list stands for the whole 
line. Expressions take on string or numeric values as 
appropriate, and are built using the operators +, -, *, /, 
%, and concatenation (indicated by a blank). The C opera- 
tors ++, ~, +=, -=, *=, /=, and %= are also available in 
expressions. Variables may be scalars, array elements 
(denoted x[i]) or fields. Variables are initialized to 
the null string. Array subscripts may be any string, not 
necessarily numeric; this allows for a form of associative 
memory. String constants are delimited with double quotes 
("). 

The print statement prints its arguments on the standard 
output (or on a file if >file is present), separated by 
the current output field separator, and terminated by the 
output record separator. The printf statement formats its 
expression list according to the format (see printf (S)). 

The built-in function length returns the length of its 
argument taken as a string, or of the whole line if no 
argument is given. There are also built-in functions exp, 
log, sqrt, and int. The last truncates its argument to an 
integer. Substr(s, m, n) returns the n-character sub- 
string of s that begins at position m. The function 
sprintf (/mt, expr, expr, ...) formats the expressions ac- 
cording to the printf (S) format given by fmt and returns 
the resulting string. 

Patterns are arbitrary Boolean combinations (!, | |, &&, 
and parentheses) of regular expressions and relational 
expressions. Regular expressions must be surrounded by 
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slashes and are as in egrep(C). Isolated regular expres- 
sions in a pattern apply to the entire line. Regular ex- 
pressions may also occur in relational expressions. 

A pattern may consist of two patterns separated by a 
comma; in this case, the action is performed for all lines 
between the first occurrence of the first pattern and the 
next occurrence of the second. 

A relational expression is one of the following: 

expression matchop regular-expression 
expression relop expression 

where a relop is any of the six relational operators in C, 
and a matchop is either ~~ (for contains) or !'~ (for does 
not contain). A conditional is an arithmetic expression, 
a relational expression, or a Boolean combination of 
these. 

The special patterns BEGIN and END may be used to cap- 
ture control before the first input line is read and after 
the last. BEGIN must be the first pattern, END the last. 

A single character c may be used to separate the fields by 
starting the program with: 

BEGIN { FS = c } 

or by using the -Fc option. 

Other variable names with special meanings include iVF, the 
number of fields in the current record; iVJ?, the ordinal 
number of the current record; FILENAME, the name of the 
current input file; OFS, the output field separator (default 
blank); ORS, the output record separator (default newline); 
and OFMT, the output format for numbers (default "%.6g"). 



Examples 

Print lines longer than 72 characters: 

awk 'length > 72' 
Print first two fields in opposite order: 

awk '{ print $2, $1 }' 
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Add up first column, print sum and average: 
awk ' { s += $1 } 

END { print "sum is", s, "average is", s/NR }' 
Print fields in reverse order: 

awk '{ for (i = NF; i > 0; -i) print $i }' 
Print all lines between start/stop pairs: 

awk '/start/, /stop/* 

Print all lines whose first field is different from previous 
one: 

awk '$1 != prev { print; prev = $1 }' 

See Also 

nawk(C), grep(C), lex(CP), sed(C) 

Notes 

There are no explicit conversions between numbers and 
strings. To force an expression to be treated as a num- 
ber, add 0 to it; to force it to be treated as a string, 
concatenate to it. Input white space is not preserved 
on output if fields are involved. 
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Name 

badblock - Adds new bad sectors to the bad sector map. 



Sjmtax 

badblock -p disk_no 

badblock [-v] [-n] -u minorjdev block no ... 
badblock [-v] -i disk no 



Description 

The badblock command displays the bad sector list and map, 
adds bad sectors to the bad sector list and map, or in- 
itializes the bad sector map from the bad sector list. 
This command can only be executed by the super user. 

-i Initializes the hard disk bad sector map from the bad 
sector list for the specified hard disk {disk no). 
This operation is executed by the system when the 
disk is initialized. 



CAUTION 

The -i option must not be used after you have 
added any bad blocks with the -u option unless 
you are completely rebuilding the disk. Doing 
so will cause bad sectors to be mapped incor- 
rectly. 



For the Series 500, if you partition the disk with 
more than one partition, the disk no is a 2-digit 
number. The first digit is the physical disk number 
(0 or 1). The second digit is the partition number 
(0, 1, 2, or 3). 

When initializing the bad sector map (-i option) on a 
Series 500, badblock will create the bad sector list 
by scanning the disk for bad sectors. 

-n No attempt is made to copy the bad block to the 
newly mapped sector. 
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-p Displays the bad sector list and bad sector map of 
the specified disk number (diskjio). 

For the Series 500, see the -i option. 

-u minor dev 

Allows new bad blocks to be added to the bad sector 
list and map. When a bad sector is found on a disk, 
an error message indicating the major/minor device 
number and bad block number is printed on the con- 
sole. The two parameters required for the -u option 
are given in this error message. The minor device 
number {minor dev) is given in the message in the 
form {major_dev/minor_dev). Use the badblock utility 
to copy the bad block to the newly mapped sector: 

badblock -u minorjdev block no 

To check that the bad block was mapped, type: 

badblock -p diskjio 

-V Lists the bad sectors map on the screen. 

Badblock will make 10 attempts to copy the sector before 
it gives up, and reports the success or failure of the 
copy. The user will be prompted before the new bad sector 
map and new bad sector list are actually written to the 
disk. The new bad sector map information will take effect 
immediately after the user permits the write of the new 
map. 



Note 

The -i and -p options are not supported on SCSI hard 
drives. 
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Name 

banner - Prints large letters. 

Syntax 

banner string ... 

Description 

Banner prints its arguments (each up to ten characters 
long per line) in large letters on the standard output. 
This is useful for printing names at the front of print- 
outs. 

See Also 

echo(C) 
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Name 

basename, diraame - Delivers portions of path names. 



Syntax 

basename string [ suffix ] 
dimame string 



Description 

Basename deletes any prefix ending in / and the suffix (if 
present in string) from stringy and prints the result on 
the standard output. It is normally used inside substitu- 
tion marks ( * * ) within shell procedures. 

Dimame delivers all but the last level of the path name 
in string. 



Examples 

The following example, invoked with the argument 
/usr/src/cmd/cat.c, compiles the named file and moves the 
output to a file named cat in the current directory: 

cc $1 

mv a. out "basename- $1 '\.c'' 

The following example will set the shell variable NAME to 
/usr/src/cmd: 

NAME= ~ dirname /usr/src/cmd/cat.c" 



See Also 

sh(C) 
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Name 



be - Arbitrary-precision arithmetic language. 



Syntax 



be [ -c ] [ -1 ] [ file ... ] 



Description 

Be is an interactive processor for a language that resem- 
bles C but provides unlimited precision arithmetic. It 
takes input from any files given, then reads the standard 
input. The bc(C) utility is actually a preprocessor for 
de(C), which it invokes automatically unless the -c option 
is present. In this case the de input is sent to the 
standard output instead. 

Be may also be used as a desktop calculator. The follow- 
ing example shows the sequence necessary to set the radix 
to base-64 and convert the decimal value 884 into its cor- 
responding base-64 representation. 



The options are as follows: 

-e Compile only. The output is sent to the standard 



-1 Argument stands for the name of an arbitrary preci- 
sion math library. 

The syntax for be programs is as follows; L means letter 
a-z, E means expression, S means statement. 

Comments are enclosed in /* and */. 



be 

obase=64 
884 1^ 

13 52 




(response from be) 



output. 
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Names 

simple variables: L 

array elements: L [ E ] 

The words ibase, obase, and scale 



Other operands 

arbitrarily long numbers with optional sign and 
decimal point. 
(E) 

sqrt (E) 

length (E) number of significant decimal digits 
scale (E) number of digits right of decimal point 
L(E,...,E) 

Operators 

+ -*/%' (% is remainder; " is power) 

++ ~ (prefix and postfix; apply to names) 

== <= >=!=<> 
= =+ =- =* =/ =% 



Statements 
E 

{S;...;S} 

if(E)S 

while (E) S 

for(E;E;E)S 

null statement 

break 

quit 

Function definitions 

define L (L,...,L) { 
auto L,...,L 
S;...S 

return (E) 

} 



Functions in -1 math library 

s(x) sine 

c(x) cosine 

e(x) exponential 

Kx) log 

a(x) arctangent 

j(n,x) Bessel function 
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All function arguments are passed by value. 

The value of a statement that is an expression is printed 
unless the main operator is an assignment. Either semi- 
colons or new-lines may separate statements. Assignment 
to scale influences the number of digits to be retained on 
arithmetic operations in the manner of dc(C). Assignments 
to ibase or obase set the input and output number radix 
respectively. 

The same letter may be used as an array, a function, and 
a simple variable simultaneously. All variables are global 
to the program. "Auto" variables are pushed down during 
function calls. When using arrays as function arguments 
or defining them as automatic variables, empty square 
brackets must follow the array name. 



Example 

scale = 20 
define e(x){ 

auto a. b, c, i, s 

a=l 

b=l 

for(i=l: 1==1; 

a=a*x 
b=b*i 
c=a/b 

if(c == 0) return(s) 
s = s+c 

} 

} 

defines a function to compute an approximate value of the 
exponential function and 

for(i-l; i<=10;i++) e{i) 

prints approximate values of the exponential function of 
the first ten integers. 
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Files 



/usr/lib/lib.b Mathematical library 

/usr/bin/dc Desk calculator proper 



See Also 
dc(C) 



Notes 

The be command does not yet recognize the logical opera- 
tors, && and I I . The for statement must have all three 
expressions (E's). Quit is interpreted when read, not 
when executed. 
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Name 

bdiff - Compares files too large for diff. 



Syntax 

bdiff filel file2 [ n ] [ -s ] 



Description 

Bdiff compares two files, finds lines that are different, 
and prints them on the standard output. It allows proces- 
sing of files that are too large for diff(C). Bdiff 
splits each file into n-line segments, beginning with the 
first nonmatching lines, and invokes diff on the corres- 
ponding segments. If both arguments are specified, they 
must appear in the order indicated above. The arguments 
are: 

n The number of lines into which bdiff splits each file 
for processing. The default value is 3500. This is 
useful when 3500-line segments are too large for 
diff(C) causing it to fail. If the optional third 
argument is given, and it is numeric, it is used as 
the value for n. 

-s Suppresses printing of bdiff diagnostics. Note that 
this does not suppress printing of diagnostics from 
diff(C), which bdiff calls. 

If filel (or file2) is a dash (-), the standard input is 
read. 

The output of bdiff is exactly like that of diff. Line 
numbers are adjusted to account for the segmenting of the 
files, and the output looks as if the files had been pro- 
cessed whole. Note that because of the segmenting of the 
files, bdiff does not necessarily find a smallest suffi- 
cient set of file differences. 
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Files 

/tmp/bd????? 

\ 

P See Also 



diff(C), help(C) 
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Name 

bfs - Big file scanner. 



Syntax 

bfs [ - ] name 



Description 

The bfs command is (almost) like ed(C) excejJt that it is 
read-only and processes much larger files. Files can be 
up to 1024K bytes and 32K lines, with up to 512 charac- 
ters, including new-line, per line (255 for 16-bit 
machines). Bfs is usually more efficient than ed(C) for 
scanning a file, since the file is not copied to a buffer. 
It is most useful for identifying sections of a large file 
where csplit(C) can be used to divide it into more manage- 
able pieces for editing. 

Normally, the size of the file being scanned is printed, 
as is the size of any file written with the w command. 
The optional - suppresses printing of sizes. Input is 
prompted with * if P and a carriage return are typed, as 
in ed(C). Prompting can be turned off again by inputting 
another P and carriage return. Note that messages are 
given in response to errors if prompting is turned on. 

All address expressions described under ed(C) are sup- 
ported. In addition, regular expressions may be sur- 
rounded with two symbols besides / and ?: > indicates 
downward search without wrap-around, and < indicates up- 
ward search without wrap-around. There is a slight dif- 
ference in mark names: only the letters a through z may 
be used, and all 26 marks are remembered. 

The e, g, v, k, p, q, w, =, ! and null commands operate 
as described under ed(C). Commands such as — , +++-, 
+++=, -12, and +4p are accepted. Note that l,10p and 1,10 
will both print the first ten lines. The f command only 
prints the name of the file being scanned; there is no 
remembered file name. The w command is independent of 
output diversion, truncation, or crunching (see the xo, xt 
and xc commands, below). 
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The following additional commands are available: 



xf file Further commands are taken from the named file. 
When an end-of-file is reached, an interrupt 
signal is received or an error occurs, reading 
resumes with the file containing the xf. The xf 
commands may be nested to a depth of 10. 

xn List the marks currently in use (marks are set 

by the k command). 

xo [file] Further output from the p and null commands is 
diverted to the named file, which, if necessary, 
is created mode 666 (readable and writable by 
everyone), unless your umask setting (see 
umask(C)) dictates otherwise. If file is miss- 
ing, output is diverted to the standard output. 
Note that each diversion causes truncation or 
creation of the file. 



: label This positions a label in a command file. The 
label is terminated by new-line, and blanks be- 
tween the : and the start of the label are ig- 
nored. This command may also be used to insert 
comments into a command file, since labels need 
not be referenced. 



( . ,. )xh /regular expression /label 

A jump (either upward or downward) is made to 
label if the command succeeds. It fails under 
any of the following conditions: 

1. Either address is not between 1 and $. 



2. The second address is less than the first. 



3. The regular expression does not match at 
least one line in the specified range, in- 
cluding the first and last lines. 

On success, . is set to the line matched and a 
jump is made to label. This command is the only 
one that does not issue an error message on bad 
addresses, so it may be used to test whether 
addresses are bad before other commands are exe- 
cuted. Note that the command: 



xh/^ /label 
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is an unconditional jump. The xb command is 
allowed only if it is read from someplace other 
than a terminal. If it is read from a pipe only 
a downward jump is possible. 

xt number 

Output from the p and null commands is trun- 
cated to at most number characters. The in- 
itial number is 255. 

xv[digit][spaces][value] 

The variable name is the specified digit following 
the XV. The conmiands xvSlOO or xv5 100 both 
assign the value 100 to the variable 5. The 
command xv61,100p assigns the value 1,1 OOp to 
the variable 6. To reference a variable, put a 
% in front of the variable name. For example, 
using the above assignments for variables 5 and 
6: 

l,%5p 

1,%5 

%6 

will all print the first 100 lines. 

g/%5/p 

would globally search for the characters 100 and 
print each line containing a match. To escape 
the special meaning of %, a \ must precede it. 

g/".*\%(cds]/p 

could be used to match and list lines containing 
printf(S) of characters, decimal integers, or 
strings. 

Another feature of the xv command is that the 
first line of output from a system command can 
be stored into a variable. The only requirement 
is that the first character of value be an !. 
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For example: 

w junk 

xv5!cat junk 

rm junk 

echo "%5" 

xv6 ! expr %6 + 1 

would put the current line into variable 5, 
print it, and increment the variable 6 by one. 
To escape the special meaning of ! as the first 
character of uaZue, precede it with a \. 

xv7\ ! date 

stores the value !date into variable 7. 

xbz label 

xbn label These two commands will test the last saved re- 
turn code from the execution of a system com- 
mand ilcommand) or nonzero value, respectively, 
to the specified label. The two examples below 
both search for the next five lines containing 
the string size. 

xv55 
:1 

/size/ 

xv5!expr%5 - 1 

!if 0%5 != 0 exit 2 

xbn 1 

xv45 

:1 

/size/ 

xv4 ! expr %4 - 1 
!if 0%4 = 0 exit 2 
xbz 1 

xc [switch] 

If switch is 1, output from the p and null com- 
mands is crunched; if switch is 0 it is not. 
Without an argument, xc reverses switch. Ini- 
tially switch is set for no crunching. Crunched 
output has strings of tabs and blanks reduced to 
one blank and blank lines suppressed. 



4 



BFS(C) 



BFS(C) 



See Also 

csplit(C), ed(C), uinask(C), more(C) 
Diagnostics 

There is a ? for errors in commands, if prompting is 
turned off. Self-explanatory error messages are produced 
when prompting is on. 
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Name 

bsh - Invokes the Business shell. 



Syntax 

bsh [-fhqs] [menusystem] 



Description 

The Business shell is a menu-driven command language in- 
terpreter. It may be installed as the "login shell" in 
the password file, or invoked directly by typing bsh. 

The bsh command is implemented using the termcap and 
curses facilities. Run bsh from a terminal defined in 
/etc/termcap. If the terminal is not defined in 
/etc/termcap, bsh will be aborted. 

The bsh command should only be run interactively, not in 
the background. 



Options 

-f Starts bsh in fast mode. In this mode, a prompt 

whose first letter is lower-case alphabetic character 
is executed immediately when the first letter is 
typed. The system does not wait for a terminating 
newline. Prompts whose first letter is upper-case 
alphabetic wait for a terminating newline before exe- 
cuting the requested actions. Fast mode is the de- 
fault mode, if not overridden by the command line or 
the BSHINIT variable (see below). The current mode 
may be changed during execution through use of the 
?mode command (described below). 

-h Displays a short help message describing how to in- 
voke bsh. 

-q Displays a one line description of the syntax used to 
invoke bsh. 
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-s Start bsh in slow mode. In this mode, all prompts 
must be terminated by a newline before execution 
occurs. The current mode may be changed during exe- 
cution through use of the ?mode command (described 
below). 

If you write your own menu system, bsh utilizes the desig- 
nated menusystem instead of the standard one 
(/etc/menusys.bin). Prior to use by bsh, a menu system 
must be "digested" using the digest utility. If it is 
not, or if it is not read-accessible, bsh issues an error 
message and terminates. 



Using the Business Shell 



Prompts 

T57ping any of the prompts on the current menu screen im- 
mediately causes the actions associated with the prompt to 
be executed. Selecting a prompt with no associated action 
causes an error message to be displayed. 

An action may be any one of the following: 

• Go to a specified menu 

• Execute a sh script 

• Execute a bsh internal conmiand 



Menu Name 

Typing the name of a menu causes it to immediately become 
the current menu. If the menu name is misspelled, or if 
it does not exist in the current menu system, an error 
message is displayed. 



New Line 

Typing a newline causes the immediately preceding menu to 
become the current one. If there is no previous menu, an 
error message is displayed. The bsh co mmand does not dis- 
tinguish between Line Feed and litl48W ~ both generate a 
newline. 
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7 

Typing a question mark (?) causes the "help" menu associ- 
ated with the current menu to be displayed. 



77 

Typing a pair of question marks (??) causes the bsh system 
help files to be displayed. It contains much the same 
information as is presented here. 



Menu Name? 

Typing the name of a menu followed by question mark calls 
up the designated help menu to become the current one. 



Icommand 

The exclamation point (!) allows you to escape to the 
standard shell (sh). The conmiand must follow the usual 
rules as described in the sh documentation. In partic- 
ular, the command may consist of a sequence of shell com- 
mands separated by semicolons - thus several actions may 
be invoked. If the command is absent, sh is invoked as a 
sub-shell with no arguments. In this case, bsh will be 
resumed as soon as the sub-shell terminates. (Usually, 
this is accomplished by sendi ng the s ub-shell an end-of- 
file message. End-of-file is TOWBiB on most terminals.) 



?index 

This special command causes bsh to display its internal 
"index" for the current menu system. The index contains 
the names of every accessible menu. 



?mode 

This special command allows you to change from "slow" mode 
to "fast" mode and vice versa. You are asked if you wish 
to change to the alternate mode. If your response begins 
with "y" or "Y", the change is made, otherwise the current 
mode remains in effect. 
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Delete 

The bsh command immediately returns to the top-level com- 
mand interpreter upon receipt of an interrupt signal. Such 
a signal is usually generated via the MiVJSkVMAMAMitM or 
Rubout key. 



backspace 

The bsh command understands the backspace function as ob- 
tained from /etc/termcap. 



Escape, Cancel 

The bsh command inte rprets th e BsBfil or Cancel key to 
mean "re-start input." KtlHWi on other terminals also 
performs this function. 



Ctrl-r 

If you cannot clear the screen, you can force bs h to clea r 
it and redisplay the current contents by pressing KtiHBUi . 



q, Q, Quit 

Typing a q, Q or Quit all have the same effect: bsh is 
terminated. If bsh is your login shell, the use of this 
command also results in your being logged out. 



Environment 

The BSHINIT environment variable contains the initial 
value of the default mode ("fast" or "slow"). If this 
variable does not exist in the environment, bsh assumes 
"fast" mode. BSHINIT should be set by inserting the line 
BSHINIT=fast or BSHINIT=slow into your .profile file. 

Note that even if bsh is designated as the "login shell" 
in /etc/passwd, your .profile file will be interpreted 
correctly (see login(C) and sh(C)). In particular, any 
overriding definitions you may have for the kill and erase 
characters will be correctly interpreted by bsh. 
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Files 

/.profile Contains commands to be executed 

during login 

/etc/menusys.bin Default menu system used by bsh 
/etc/passwd Used to define a user's login name, 

password, home directory, shell 
/etc/termcap Contains terminal attribute descrip- 

tions 



See Also 

login(C), sh(C), termcap(M) 
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Name 

cal - Prints a calendar. 



Syntax 

cal [[ month ] year ] 



Description 

Cal prints a calendar for the specified year. If month is 
also specified, a calendar for that month only is printed. 
If no arguments are specified, a calendar for the current 
month is printed. Year must be a number between 1 and 
9999; month must be a number between 1 and 12. 



Notes 

Note that "cal 84" refers to the year 84, not 1984. 

The calendar produced is that for England and her colonies. 
Note that England switched from the Julian to the Gregor- 
ian calendar in September of 1752, at which time eleven 
days were excised from the year. To see the result of 
this switch, try cal 9 1752. 
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Name 

calendar - Invokes a reminder service. 



Syntax 

calendar [ - ] 



Description 

Calendar looks at the file named calendar in the user's 
current directory, and prints (to the user's terminal) 
lines that contain today's or tomorrow's date. Month-day 
dates such as "Sep. 7," "September 7", and "9/7", are 
recognized, but not "7 September", "7/9" or "07/09" for 
September 7. 

On weekends, "tomorrow" extends through Monday. Lines 
that contain the date of a Monday will be sent to the user 
on the previous Friday. This is not true for holidays. 

When an argument is present, calendar does its job for 
every user who has a calendar file in his login directory 
and sends the user the results by mail(C). Normally this 
is done daily, in the early morning, under the control of 
cron(C). 



Files 

calendar 

/usr/lib/calprog To figure out today's and tomorrow's 
dates 

/etc/passwd 

/tmp/cal* 

/usr/lib/crontab 



See Also 

cron(C), mail(C) 
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Notes 



To get reminder service, a user's calendar file must have 
read permission for all. 
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Name 

cat - Concatenates and prints files. 



Syntax 

cat [ -u ] [ -s ] [ -V [-t] [-e] ] file.,. 



Description 

Cat reads each file in sequence and writes it on the stan- 
dard output. Thus: 

cat file 

prints the file, and: 

cat filel file2 >file3 

concatenates the first two files and places the result in 
the third. 

If no input file is given, or if the argument - is encoun- 
tered, cat reads from the standard input. 

The following options apply to cat. 

-u The output is not buffered. (The default is buffered 
output.) 

-s Cat is silent about non-existent files. 

-V Causes non-printing characters (with the exception of 
tabs, new-lines, and form-feeds) to be printed visi- 
bly. Control characters are printed "X (control-x); 
the DEL character (octal 0177) is printed 
Non-ASCII characters (with the high bit set) are 
printed as M-x, where x is the character specified by 
the seven low-order bits. 



1 



CAJ(C) 



CAT(C) 



When used with the -v option, the following options may be 
used. 

-t Causes tabs to be printed as "I's. 

-e Causes a $ character to be printed at the end of each 
line (prior to the new-line). 

The -t and -e options are ignored if the -v option is not 
specified. 

Notes 

Command formats such as 

cat filel file2 yfilel 

will cause the original data in filel to be lost; there- 
fore, take care when using shell special characters. 

See Also 

cp(C), pg(C), pr(C) 
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Name 

cd - Changes directory. 

Syntax 

cd [directory] 

Description 

Use the cd command to change directories. Typing cd with 
no argument places you in your login (home) directory. 
This command is built into the shells; it is not a sepa- 
rate conmiand. 

Examples 

This command moves you up one level of your directory, 
cd .. 

This command changes the current directory to 
/usr/wendy/memos/meetings. 

cd /usr/wendy/memos/meetings 

This conmiand moves you into the April directory, which is 
a subdirectory of the Letters directory. 

cd Letters/April 

Related Commands 
pwd(C), sh(C) 
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Name 

chmod - Changes the access permissions of a file or direc- 
tory. 



Syntax 

chmod mode file... 
chmod mode directory... 



Description 

The permissions of the named files or directories are 
changed according to mode, which may be symbolic or abso- 
lute. Absolute changes to permissions are stated using 
octal numbers: 

chmod nnn file 

where n is a number from 0 to 7. Ssmibolic changes are 
stated using mnemonic characters: 

chmod a operator b file 

where a is one or more characters corresponding to user, 
group, or other; where operator is +, -, and =, signifying 
assignment of permissions; and where b is one or more 
characters corresponding to type of permission. 

An absolute mode is given as an octal number constructed 
from the OR of the following modes: 

4000 set user ID on execution 

2000 set group ID on execution 

1000 sticky bit is turned on ((see chmod(S)) 

0400 read by owner 

0200 write by owner 

0100 execute (search in directory) by owner 

0070 read, write, execute (search) by group 

0007 read, write, execute (search) by others 

Symbolic changes are stated using letters that correspond 
both to access classes and to the individual permissions 
themselves. 
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Permissions to a file may vary depending on your user 
identification number (UID) or group identification number 
(GID). Permissions are described in three sequences each 
having three characters: 

User Group Other 

rwx rwx rwx 

This example (meaning that user, group, and others all 
have reading, writing, and execution permission to a given 
file) demonstrates two categories for granting permis- 
sions: the access class and the permissions themselves. 

Thus, to change the mode of a file's (or directory's) per- 
missions using chmod's symbolic method, use the following 
syntax for mode: 

[ who ] operator [ permission(s) ],... 

A command line using the symbolic method would appear as 
follows: 

chmod g+rw file 

This command would make file readable and writable by the 
group. 

The who part can be stated as one or more of the following 
letters: 

u user's permissions 
g group's permissions 
o others permissions 

The letter a (all) is equivalent to ugo and is the default 
if who is omitted. 

Operator can be + to add permission to the file's mode, - 
to take away permissiouj or = to assign permission abso- 
lutely. (Unlike other symbolic operations, = has an abso- 
lute effect in that it resets all other bits.) Omitting 
permission is only useful with = to take away all permis- 
sions. 
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Permission is any compatible combination of the following 
letters: 



r reading permission 

w writing permission 

X execution permission 

s user or group set-ID is turned on 

t sticky bit is turned on 



Multiple symbolic modes separated by commas may be given, 
though no spaces may intervene between these modes. 
Operations are performed in the order given. Multiple 
S57mbolic letters following a single operator cause the 
corresponding operations to be performed simultaneously. 
The letter s is only meaningful with u or g, and t only 
works with u. 

Only the owner of a file or directory (or the super-user) 
may change a file's mode. Only the super-user may set the 
sticky bit. In order to turn on a file's set-group- ID, 
your own group ID must correspond to the file's, and group 
execution must be set. 



Examples 

chmod a-x file 
chmod 444 file 

The first example denies execution permission to all. The 
absolute (octal) example permits only reading permissions. 

chmod go+rw file 

chmod 666 file 

These examples make a file readable and writable by the 
group and others. 

chmod =rwx,g+s file 

chmod 2777 file 

These last two examples enable all to read, write, and 
execute the file; and they turn on the set-group-ID. 
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Notes 

In a Remote File Sharing environment, you may not have 
the permissions that the output of the Is -1 command leads 
you to believe. For more information see the Remote File 
Sharing manual. 



See Also 

ls(C) and chmod(S) in the Reference (CP, S, F) 
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Name 

chown, chgrp - Changes owner or group. 



Syntax 

chown owner file... 
chown owner directory... 
chgip group file... 
chgrp group directory... 



Description 

Chown changes the owner of the files or directories to 
owner. The owner may be either a decimal user ID or a 
login name found in the password file. Chgrp changes the 
group ID of the files or directories to group. The group 
may be either a decimal group ID or a group name found in 
the group file. If either conmiand is invoked by other 
than the super-user, the set-user-ID and setgroup-ID bits 
of the file mode, 04000 and 02000 respectively, will be 
cleared. Only the owner of a file (or the super-user) may 
change the owner or group of that file. 



Files 

/etc/passwd 
/etc/group 



Notes 

In a Remote File Sharing environment, you may not have the 
permissions that the output of the Is -1 command leads you 
to believe. For more information see the Remote File 
Sharing manual. 
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See Also 

chmod(C), group(M), passwd(M) and chown(S) in the Refer- 
ence (CP, S, F) 
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Name 

chroot - Changes the root directory for a command. 



Syntax 

/etc/chroot neioroot command 



Description 

Chroot causes the given command to be executed relative to 
the new root. The meaning of any initial slashes (/) in 
the path names is changed for the command and any of its 
child processes to newroot. Furthermore, upon execution, 
the initial working directory is newroot. 

Notice, however, that if you redirect the output of the 
command to a file: 

chroot newroot command >x 

will create the file x relative to the original root of 
the command, not the new one. 

The new root path name is always relative to the current 
root: even if a chroot is currently in effect, the 
newroot argument is relative to the current root of the 
running process. 

This command can be run only by the super-user. 



See Also 

cd(C) and chroot(S) in the Reference (CP, S, F) 



Notes 

One should exercise extreme caution when referencing de- 
vice files in the new root file system. 
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Name 

clear - Clears terminal screen. 

Syntax 

clear 
Description 

Clear clears your screen. It looks in the environment for 
the terminal tj^e and then in /etc/lib/terminfo to figure 
out how to clear the screen. 

Files 

/etc/lib/terminfo Terminal information data base 
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Name 

cmp - Compares two files. 
Syntax 

cmp [ -1 ] [ -s ] filel file2 



Description 

Cmp compares two files and, if they are different, dis- 
plays the byte and line numbers of the differences. If 
filel is -, the standard input is used. 

The options are: 

-1 Prints the byte number (decimal) and the differing 
bytes (octal) for each difference. 

-s Returns an exit code only, 0 for identical files, 1 
for different files, and 2 for an inaccessible or 
missing file. 

This command should be used to compare binary files; use 
diff(C) or diff3(C) to compare text files. 



See Also 

comm(C), diff(C), diff3(C) 



Diagnostics 

Exit code 0 is returned for identical files, 1 for differ- 
ent files, and 2 for an inaccessible or missing argument. 



1 



COMM(C) 



COMM(C) 



Name 

comm - Selects or rejects lines common to two sorted 
files. 



Syntax 

comm [ - [ 123 ] ] filel file2 



Description 

Conmi reads filel and file2f which should be ordered in 
ASCII collating sequence (see sort(C)), and produces a 
three-column output: lines only in filel; lines only in 
file2; and lines in both files. A - for filel means the 
standard input. 

The 1, 2, or 3 flags suppress printing of the correspond- 
ing column. Thus comm -12 prints only the lines common to 
the two files; comm -23 prints only lines in the first 
file but not in the second; comm -123 doesn't work and 
will print nothing. 



See Also 

cmp(C), diff(C), sort(C), uniq(C) 
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Name 

copy - Copies groups of files. 



Syntax 

copy [ option ] ... source ... dest 



Description 

The copy command copies the contents of directories to 
another directory. It is possible to copy whole file sys- 
tems since directories are made when needed. 

If files, directories, or special files do not exist at 
the destination, then they are created with the same modes 
and flags as the source. In addition, the super-user may 
set the user and group ID. The owner and mode are not 
changed if the destination file exists. Note that there 
may be more than one source directory. If so, the effect 
is the same as if the copy conmiand had been issued for 
each source directory with the the same destination direc- 
tory for each copy. 

All of the options must be given as separate arguments and 
they may appear in any order even after the other argu- 
ments. The options are: 

-a Asks the user before attempting a copy. If the re- 
sponse does not begin with a "y" for yes, then a copy 
is not done. This option also sets the -ad option. 

-1 Uses links whenever they can be used. Otherwise a 
copy is done. Note that links are never used for 
special files or directories. 

-n Requires the destination file to be new. If not, 

then the copy command does not change the destina- 
tion file. The -n flag is meaningless for directories. 
For special files, an -n flag is assumed (i.e., the 
destination of a special file must not exist). 
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-o If set, then every file copied has its owner and 
group set to those of the source. If not set, then 
the file's owner is the user who invoked the program. 

-m If set, then every file copied has its modification 
time and access time set to that of the source. If 
not set, then the modification time is set to the 
time of the copy. 

-r If set, then every directory is recursively examined 
as it is encountered. If not set, then any director- 
ies that are found are ignored. 

-ad Asks the user whether an -r flag applies when a di- 
rectory is discovered. If the answer does not begin 
with a "y»" then the directory is ignored. 

-V If the verbose option is set, messages are printed 
that reveal what the program is doing, source This 
may be a file, directory or special file. It must 
exist. If it is not a directory, then the results of 
the command are the same as for the cp(C) command. 

dest 

The destination must be either a file or directory 
that is different from the source. 

If source and destination are anything but directories, 
then copy acts just like a cp command. If both are direc- 
tories, then copy copies each file into the destination 
directory according to the flags that have been set. 



Notes 

Special device files can be copied. When they are copied, 
any data associated with the specified device is not 
copied. 
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Name 

cp - Copies files. 

Syntax 

cp filel file2 

cp file directory 

cp -r directory 1 directory 2 



Description 

Use the cp command to make a copy of a file within the 
same directory or to copy a file from one directory to 
another. In the latter case you can either rename the 
file or keep the same name. 

The -r option recursively copies directory trees. 

NOTE 

You cannot copy a directory into a file. 

Examples 

This conmiand makes a copy of the file letterl and renames 
it letter2. 

cp letterl letter2 

This command places a copy of file letterl in the direc- 
tory January. 

cp letterl January /letterl 

Related Commands 

ln(C), mv(C), rm(C) 
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Name 

cpio - Copies file archives in and out. 



Syntax 



cpio -o [aBcvV] [-Cbufsize] [-Mmessage] <name-list >collection 

cpio -o [aBcvV] -Ocollection l-Cbufslze] [-Mmessage] <name-list 

cpio -i [bBcdfkinrsStuvV6] l-Cbufsize] [-Mmessage] [pattern] <coHection 

cpio -i [bBcdfkmrsStuvVe] -Icollection [-Cbufsize] [-Mmessage] [pattern] 

cpio -p tadlmruvV] directory <name-list 



Description 

Cpio -o (copy out) reads the standard input to obtain a 
list of pathnames and copies those files onto the standard 
output together with pathname and status information. 

Cpio -i (copy in) extracts from the standard input (which 
is assumed to be the product of a previous cpio -o) the 
names of files selected by zero or more patterns given in 
the ngune-generating notation of sh(C). In patterns, the 
special characters ?, *, and [...] match the slash (/) 
character. The default for patterns is * (i.e., select 
all files). 

Remember to escape special characters to prevent expansion 
by the shell. 

Cpio -p (pass) copies out and in during a single opera- 
tion. Destination pathnames are interpreted relative to 
the named directory. 

The meanings of the available option flags are: 

-a Resets access times of input files after they have 
been copied. 

-b Swaps both bytes and halfwords. Use only with the -i 
option. 

-B Blocks input/output 512 bytes to the record (does not 
apply to the pass option; meaningful only with data 
directed to or from raw devices). 
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-c Writes header information in ASCII character form for 
portability. 

-Cbufsize 

Sets buffer size to bufsize. 

-d Directories are created as needed. 

-f Do not consider patterns on the command line. 

-Icollection 

Reads input from collection instead of standard 
input. 

-k In case of I/O errors in reading, tries several times 
before reporting I/O error and exiting. If the file 
header is corrupted, prints a message about the sit- 
uation and continues reading input. 

-1 Whenever possible, links files rather than copying 
them. Usable only with the -p (pass) option. 

-m Retains previous file modification time. This option 
is ineffective on directories that are being copied. 

-Mmessage 

Sets alternate message message for end-of-media. 
-Ocollection 

Writes output to collection instead of standard 
output. 

-r Interactively renames files. If the user types a 
null line, the file is skipped. 

-s Swaps bytes. Use only with the -i option. 

-S Swaps halfwords. Use only with the -i option. 

-t Prints a table of contents of the input. No files 
are created. 

-u Copies unconditionally (normally an older file will 
not replace a newer file with the same name). 



2 



CPIO(C) 



CP 10(C) 



-V Verbose. Causes a list of filenames to be printed. 
When used with the -t option, the table of contents 
looks like the output of an Is -1 command (see 
ls(C)). 

-V Verbose. Prints a dot (.) for each file. 

-6 Processes an old file. Use only with the -i (copy 
in) option. 



Examples 

The first example copies the contents of a directory into 
an archive; the second duplicates a directory hierarchy: 

Is I epic -o >/dev/fdO 

cd olddir 

find . -print | epic -pdl newdir 

or: 

find . -print | epic -oB >/dev/rfdO 



See Also 

ar(CP), cpio(F), find(C) 



Notes 

Pathnames are restricted to 128 characters. If there are 
too many unique linked files, the program runs out of mem- 
ory to keep track of them; thereafter, linking information 
is lost. Only the super-user can copy special files. 
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Name 

cpset - Installs utilities. 
Syntax 

/etc/cpset [-o] filename destination [mode] [owner] [group] 
Description 

The cpset command is used by make files to install new 
utilities. You can also invoke this command from the com- 
mand line. 



Options 



-o 



If filename already exists, cpset moves it 
to OLDfilename. 



filename 



The name of the utility you want to in- 
stall. 



destination 



The destination directory of the utility. 



mode 



Permissions for the utility (default is set 
by umask(C)). 



owner group 



The user and group id for the installed 
utility. 



See Also 



chgrp(C), chmod(C), chown(C), make(C), umask(C) 
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Name 

cron - Executes commands at specified dates and times. 



Sjmtax 

/etc/cron 



Description 

Cron executes commands at specified dates and times. 
Regularly scheduled conmiands can be specified according to 
instructions found in crontab files (in the 
/usr/spool/cron/crontabs directory). Users can submit 
their own crontab file by using the crontab(C) command. 
Since cron never exits, it should only be executed once. 
This is best done by running cron from the initialization 
process through the file /etc/rc2.d/S??cron. 

The file crontab consists of lines of six fields each. 
The fields are separated by spaces or tabs. The first 
five are integer patterns to specify the minute (0-59), 
hour (0-23), day of the month (1-31), month of the year 
(1-12), and day of the week (0-6 with 0=Sunday). Each of 
these patterns may contain a number in the range above, 
two numbers separated by a minus means a range (inclusive); 
a list of numbers separated by commas means any of the 
numbers; or an asterisk meaning all legal values. The 
sixth field is a string that is executed by the shell at 
the specified times. A percent character in this field is 
translated to a new-line character. Only the first line 
(up to a % or end of line) of the command field is exe- 
cuted by the Shell. The other lines are made available to 
the command as standard input. 

Cron only examines crontab files during process initiali- 
zation and when a file changes. This reduces the overhead 
of checking for new or changed files at regularly sched- 
uled intervals. 
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Examples 

A sample crontab file follows: 

0,5,10,15,20,25,30,35,40,45,50,55 * * * * /usr/lib/atrun 
0,10,20,30,40,50 * * * * /etc/dmesg ->>/usr/adm/messages 
1,21,41 * * * * (echo -n ' '; date; echo ) >/dev/console 

Cron creates log entries in /usr/lib/cron/log. Be sure 
to monitor the size of /usr/lib/cron/log so that it 
doesn't unreasonably consume disk space. 



Files 

/usr/lib/cron Main cron directory 

/usr/lib/cron/log Accounting information 

/usr/spool/cron Spool area 



See Also 

crontab(C), sh(C), init(M) 
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Name 

crontab - User crontab file. 



Syntax 

crontab [file] 

crontab -r 

crontab -1 



Description 

Crontab copies the specified file, or standard input, if 
no file is specified, into a directory that holds all 
users' crontabs. The -r option removes a user's crontab 
from the crontab directory. The -1 option lists your own 
crontab file. 

Users are permitted to use crontab if their names appear 
in the file /usr/lib/cron/cron. allow. If that file does 
not exist, the file /usr/lib/cron/cron. deny is checked to 
determine if the user should be denied access to crontab. 
If neither file exists, only root can submit a job. If 
either file is at. deny, global usage is permitted. The 
allow/deny files consist of one user name per line. 

A crontab file consists of lines of six fields each. The 
fields are separated by spaces or tabs. The first five 
are integer patterns that specify the following: 

minute (0-59) 
hour (0-23) 

day of the month (1-31) 

month of the year (1-12) 

day of the week (0-6 with 0=Sunday) 

Each of these patterns may be either an asterisk (that is, 
all legal values) or a list of elements separated by commas. 
An element is either a number or two numbers separated by 
a minus sign (that is, an inclusive range). Two fields 
specify days (day of the month and day of the week). If 
both are specified as a list of elements, both are adhered 
to. For example, 0 0 1,15 * 1 runs a command on the first 
and fifteenth of each month, as well as on every Monday. 
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To specify days by only one field, set the other fields to 
* (for example, 0 0**1 would run a command only on 
Mondays). 

The sixth field of a line in a erontab file is a string 
that is executed by the shell at the specified times. A 
percent character in this field (unless escaped by a \) is 
translated to a new-line character. Only the first line 
(up to a % or end of line) of the command field is exe- 
cuted by the shell. The other lines are made available to 
the command as standard input. 

The shell is invoked from your $HOME directory with an 
argO of sh. Users who desire to have their .profile exe- 
cuted must explicitly do so in the erontab file. Cron sup- 
plies a default environment for every shell, defining HOME, 
LOGNAME, SHELL(=/bin/sh), and PATH(=:/bin:/usr/bin). 



Files 



/usr/lib/cron 

/usr/spool/cron/crontabs 

/usr/lib/cron/log 

/usr /lib/cron/cron. allow 

/usr/lib/cron/cron.deny 



Main cron directory 
Spool area 

Accounting information 
List of allowed users 
List of denied users 



See Also 



sh(C), cron(C) 



Notes 



Remember to redirect the standard output and standard 
error of commands! If not, any generated output or errors 
will be mailed to you. 



If you inadvertently enter the erontab comman d with no 
argument (s), do not attempt to get out with a KtitiBim . 
This will cause all entries in y our erontab f ile to be 
removed. Instead, exit with a 



Break/Dei 



2 



CSH(C) 



CSH(C) 



Name 

csh - Invokes a shell command interpreter with C-like 
syntax. 



Syntax 

csh [ -cefinstvVxX ] [ arg ... ] 



Description 

The csh command, a command language interpreter, begins 
by executing conmiands from the file .cshrc in the user's 
home directory. If this is a login shell, csh also exe- 
cutes commands from the file .login in the user's home 
directory. The shell will then begin reading commands 
from the terminal, prompting with %. 

The shell then repeatedly performs the following actions: 
a line of command input is read and broken into words. 
This sequence of words is placed on the command history 
list and then parsed. Finally each command in the current 
line is executed. 

When a login shell terminates, it executes conmaands from 
the file .logout in the user's home directory. 



Lexical Structure 

The shell splits input lines into words at blanks and tabs 
with the following exceptions. The characters &, |, ;, <, 
>, (, ) form separate words. If the |, <, or > characters 
are doubled (||, «, or »), these pairs form single 
words. The parser metacharacters may be made part of 
other words, or prevented their special meaning, by pre- 
ceding them with a backslash (\). A new line preceded by 
a \ is equivalent to a blank. 

In addition, strings enclosed in matched pairs of quota- 
tions (', \ or ") form parts of a word; metacharacters in 
these strings, including blanks and tabs, do not form sep- 
arate words. Within pairs of \ or " characters, a new 
line preceded by a \ gives a true newline character. 
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When the shell's input is not a terminal, the character # 
introduces a comment which continues to the end of the 
input line. It does not have this special meaning when 
preceded by a \ and placed inside the quotation marks % 
or ". 



Commands 

A simple command is a sequence of words, the first of 
which specifies the command to be executed. A simple 
command or a sequence of simple commands separated by | 
characters forms a pipeline. The output of each command 
in a pipeline is connected to the input of the next. Se- 
quences of pipelines may be separated by a semi-colon (;), 
and are then executed sequentially. A sequence of pipe- 
line commands may be executed without waiting for them to 
terminate by following it with an &. Such a sequence is 
automatically prevented from being terminated by a hangup 
signal; the nohup command need not be used. 

Any of the above may be placed in parentheses to form a 
simple command which may be a component of a pipeline, 
etc. It is also possible to separate pipelines with | | or 
&& indicating, as in the C language, that the second is to 
be executed only if the first fails or succeeds respec- 
tively. (See "Expressions.") 



Substitutions 

The following sections describe the various transforma- 
tions the shell performs on the input in the order in 
which they occur. 



History Substitutions 

History substitutions can be used to reintroduce sequences 
of words from previous commands, possibly performing modi- 
fications on these words. Thus history substitutions pro- 
vide a generalization of a redo function. 

History substitutions begin with the character ! and may 
begin anywhere in the input stream if a history substitu- 
tion is not already in progress. This ! may be preceded 
by a \ to prevent its special meaning; a ! is passed un- 
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changed when it is followed by a blank, tab, newline, =, 
or (. History substitutions also occur when an input line 
begins with This special abbreviation will be described 
later. 

Any input line which contains history substitution is 
echoed on the terminal before it is executed as it could 
have been typed without history substitution. 

Commands input from the terminal which consist of one or 
more words are saved on the history list, the size of which 
is controlled by the history variable. The previous com- 
mand is always retained. Commands are numbered sequen- 
tially from 1. 

For example, consider the following output from the history 
command: 



9 writd michdel 

10 ex writ«.c 

11 cat oXdwrlte.c 

12 diff *wrlte.c 



The commands are shown with their event numbers. It is 
not usually necessary to use event numbers, but the cur- 
rent event number can be made part of the prompt by plac- 
ing a ! in the prompt string. 

With the current event 13 we can refer to previous events 
by event number 111, relatively as in !-2 (referring to 
the same event), by a prefix of a command word as in !d 
for event 12 or !w for event 9, or by a string contained 
in a word in the command as in !?mic? also referring to 
event 9. These forms, without further modification, 
simply reintroduce the words of the specified events, each 
separated by a single blank. As a special case !! refers 
to the previous command; thus !! alone is essentially a 
redo. The form I# references the current commahd (the 
one being typed in). It allows a word to be selected from 
further left in the line, to avoid retyping a long name, 
as in 
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To select words from an event we can follow the event spe- 
cification by a : and a designator for the desired words. 
The words of an input line are numbered from 0, the first 
(usually conmiand) word being 0, the second word (first 
argument) being 1, and so on. The basic word designators 
are: 

0 First (command) word 
n nth argument 

First argument, i.e., 1 
$ Last argument 

% Word matched by (immediately preceding) 

?s? search 

x-y Range of words 

-y Abbreviates 0-y 

* Abbreviates "-$, or nothing if only one word in event 

X* Abbreviates x-$ 

X- Like X* but omitting word $ 

The : separating the event specification from the word 
designator can be omitted if the argument selector begins 
with a , $, *, -, or %. After the optional word desig- 
nator a sequence of modifiers can be placed, each preceded 
by a :. The following modifiers are defined: 

h Removes a trailing pathname component 

r Removes a trailing .xxx component 

s/l/r/ 

Substitutes / for r 
t Removes all leading pathname components 
& Repeats the previous substitution 
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g Applies the change globally, prefixing the above 

p Prints the new command but does not execute it 

q Quotes the substituted words, preventing substitu- 
tions 

X Like q, but breaks into words at blanks, tabs, and 
newlines 

Unless preceded by a g, the modification is applied only 
to the first modifiable word. In any case it is an error 
for no word to be applicable. 

The left side of substitutions are not regular expressions 
in the sense of the editors, but rather strings. Any 
character may be used as the delimiter in place of /; a \ 
quotes the delimiter into the I and r strings. The char- 
acter & in the right side is replaced by the text from the 
left. A \ quotes & also. A null I uses the previous 
string either from a I or from a contextual scan string s 
in I?s?. The trailing delimiter in the substitution may 
be omitted if a newline follows immediately as may the 
trailing ? in a contextual scan. 

A history reference may be given without an event specifi- 
cation, e.g., 1$. In this case the reference is to the 
previous command unless a previous history reference oc- 
curred on the same line in which case this form repeats 
the previous reference. Thus I?foo?'I$ gives the first 
and last arguments from the command matching ?foo?. 

A special abbreviation of a history reference occurs when 
the first nonblank character of an input line is a 
This is equivalent to Irs", providing a convenient short- 
hand for substitutions on the text of the previous line. 
Thus "Ib'lib fixes the spelling of lib in the previous 
command. Finally, a history substitution may be sur- 
rounded with { and } if necessary to insulate it from the 
characters that follow. Thus, after Is -Id paul we might 
do !{I}a to do Is -Id paula, while !la would look for a 
command starting la. 
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Quotations With ' and " 

The quotation of strings by ' and " can be used to prevent 
all or some of the remaining substitutions. Strings en- 
closed in ' are prevented any further interpretation. 
Strings enclosed in " are variable and command expansion 
may occur. 

In both cases, the resulting text becomes (all or part of) 
a single word; only in one special case (see "Command 
Substitution" below) does a " quoted string yield parts of 
more than one word; ' quoted strings never do. 



Alias Substitution 

The shell maintains a list of aliases which can be estab- 
lished, displayed and modified by the alias and unalias 
commands. After a command line is scanned, it is parsed 
into distinct commands and the first word of each command, 
left-to-right, is checked to see if it has an alias. If 
it does, then the text which is the alias for that conmiand 
is reread with the history mechanism available as though 
that command were the previous input line. The resulting 
words replace the conmiand and argument list. If no refer- 
ence is made to the history list, then the argument list 
is left unchanged. 

Thus, if the alias for Is is Is -1, the command Is /usr 
would map to Is -1 /usr. Similarly if the alias for look- 
up was grep !" /etc/passwd, then lookup bill would map to 
grep bill /etc/passwd. 

If an alias is found, the word transformation of the input 
text is performed and the aliasing process begins again on 
the reformed input line. Looping is prevented if the 
first word of the new text is the same as the old by flag- 
ging it to prevent further aliasing. Other loops are de- 
tected and cause an error. 

Note that the mechanism allows aliases to introduce parser 
metasyntax. Thus, we can alias print 'pr \l* \ Ipr' to 
make a command that paginates its arguments to the line- 
printer. 
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Variable Substitution 

The shell maintains a set of variables, each of which has 
as a value a list of zero or more words. Some of these 
variables are set by the shell or referred to by it. For 
instance, the argv variable is an image of the shell's 
argument list, and words of this variable's value are re- 
ferred to in special ways. 

The values of variables may be displayed and changed by 
using the set and unset commands. Of the variables re- 
ferred to by the shell, a number are toggles; the shell 
does not care what their value is, only whether they are 
set or not. For instance, the verbose variable is a 
toggle that causes command input to be echoed. The set- 
ting of this variable results from the -v command line 
option. 

Other operations treat variables numerically. The at-sign 
(@) command permits numeric calculations to be performed 
and the result assigned to a variable. However, variable 
values are always represented as (zero or more) strings. 
For the purposes of numeric operations, the null string is 
considered to be zero, and the second and subsequent words 
of multiword values are ignored. 

After the input line is aliased and parsed, and before 
each command is executed, variable substitution is per- 
formed, keyed by dollar sign ($) characters. This expan- 
sion can be prevented by preceding the dollar sign with a 
backslash (\) except within double quotation marks (") 
where it always occurs, and within single quotation marks 
(•) where it never occurs. Strings quoted by back quota- 
tion marks C) are interpreted later (see "Command Sub- 
stitution" below) so dollar sign substitution does not 
occur there until later, if at all. A dollar sign is 
passed unchanged if followed by a blank, tab, or end-of- 
line. 

Input and output redirections are recognized before vari- 
able expansion and are variable expanded separately. 
Otherwise, the command name and entire argument list are 
expanded together. It is thus possible for the first 
(command) word to generate more than one word, the first 
of which becomes the command name, and the rest of which 
become arguments. 
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Unless enclosed in double quotation marks or given the :q 
modifier, the results of variable substitution may even- 
tually be command and filename substituted. Within double 
quotation marks ("), a variable whose value consists of 
multiple words expands to a portion of a single word, with 
the words of the variable's value separated by blanks. 
When the :q modifier is applied to a substitution the var- 
iable expands to multiple words with each word separated 
by a blank and quoted to prevent later command or filename 
substitution. 

The following sequences are provided for introducing vari- 
able values into the shell input. Except as noted, it is 
an error to reference a variable that is not set. 

$name 

${name} Are replaced by the words of the value of 

variable name, each separated by a blank. 
Braces insulate name from following char- 
acters which would otherwise be part of it. 
Shell variables have names consisting of up 
to 20 letters, digits, and underscores. 

If name is not a shell variable, but is set 
in the environment, then that value is re- 
turned; however, modifiers and the other 
forms given below are not available in this 
case. 

$name[selector] 

${name[selector]} 

May be used to select only some of the 
words from the value of name. The selec- 
tor is subjected to $ substitution and may 
consist of a single number or two numbers 
separated by a -. The first word of a 
variable's value is numbered 1. If the 
first number of a range is omitted it de- 
faults to 1. If the last member of a range 
is omitted it defaults to $#name. The se- 
lector * selects all words. It is not an 
error for a range to be empty if the second 
argument is omitted or in range. 
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$1tname 
${1tname} 



$0 



$mmber 
${number} 



Gives the number of words in the variable. 
This is useful for later use in a 
[selector]. 

Substitutes the name of the file from which 
command input is being read. An error oc- 
curs if the name is not known. 



Equivalent to $argv[number]. 
Equivalent to $argu[*]. 



The modifiers :h, :t, :r, :q and :x may be applied to the 
substitutions above as may :gh, :gt, and :gfr. If braces 
{ } appear in the command form, then the modifiers must ap- 
pear within the braces. Only one : modifier is allowed 
on each $ expansion. 

The following substitutions may not be modified with : 
modifiers. 



$?name 
${1name} 



$?0 



Substitutes the string 1 if name is set, 0 
if it is not. 

Substitutes 1 if the current input filename 
is known, 0 if it is not. 

Substitutes the (decimal) process number of 
the (parent) shell. 



Command and Filename Substitution 

Command and filename substitution are applied selectively 
to the arguments of built-in commands. This means that 
portions of expressions which are not evaluated are not 
subjected to these expansions. For commands which are not 
internal to the shell, the command name is substituted 
separately from the argument list. This occurs very late, 
after input-output redirection is performed, and in a 
child of the main shell. 
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Command Substitution 

Command substitution is indicated by a conmiand enclosed in 
back quotation marks. The output from such a command is 
normally broken into separate words at blanks, tabs and 
newlines, with null words being discarded, this text then 
replacing the original string. Within double quotation 
marks, only newlines force new words; blanks and tabs are 
preserved. 

In any case, the single final newline does not force a new 
word. Note that it is thus possible for a command substi- 
tution to yield only part of a word, even if the conmiand 
outputs a complete line. 



Filename Substitution 

If a word contains any of the characters *, ?, [, or {, or 
begins with the character then that word is a candidate 
for filename substitution, also known as globbing. This 
word is then regarded as a pattern, and replaced with an 
alphabetically sorted list of filenames which match the 
pattern. In a list of words specifying filename substitu- 
tion it is an error for no pattern to match an existing 
filename, but it is not required for each pattern to 
match. Only the metacharacters *, ?, and [ imply pattern 
matching, the characters * and { being more akin to abbre- 
viations. 

In matching filenames, the character . at the beginning 
of a filename or immediately following a /, as well as the 
character / must be matched explicitly. The character * 
matches any string of characters, including the null 
string. The character ? matches any single character. 
The sequence [...] matches any one of the characters en- 
closed. Within [...], a pair of characters separated by - 
matches any character lexically between the two. 

The character * at the beginning of a filename is used to 
refer to home directories. Standing alone, it expands to 
the invoker's home directory as reflected in the value of 
the variable home. When followed by a name consisting of 
letters, digits, and - characters, the shell searches for 
a user with that name and substitutes the user's home di- 
rectory; thus "ken might expand to /usr/ken and 
'ken/chmach to /usr/ken/chmach. If the character ~ is 
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followed by a character other than a letter or /, or ap- 
pears not at the beginning of a word, it is left un- 
changed. 

The metanotation a{b,c,d}e is a shorthand for abe ace ade. 
Left to right order is preserved, with results of matches 
being sorted separately at a low level to preserve this 
order. This construct may be nested. Thus 
~source/sl/{oldls,ls}.c expands to /usr/source/sl/oldls.c 
/usr/source/sl/ls.c, whether or not these files exist, 
without any chance of error if the home directory for 
source is /usr/source. Similarly ../{memo,*box} might 
expand to ../memo ../box ../mbox. (Note that memo was 
not sorted with the results of matching *box.) As a spe- 
cial case {, }, and {} are passed unchanged. 



Input/Output 

The standard input and standard output of a command may 
be redirected with the following sjmtax: 

< name Opens file name (which is first variable, 

command and filename expanded) as the 
standard input. 

« word Reads the shell input up to a line which is 

identical to word. The variable word is 
not subjected to variable, filename, or 
command substitution, and each input line 
is compared to word before any substitu- 
tions are made on this input line. Unless 
a quoting backslash, double, or single quo- 
tation mark, or a back quotation mark ap- 
pears in wordy variable and command substi- 
tution is performed on the intervening 
lines, allowing \ to quote $, \, and \ 
Commands that are substituted have all 
blanks, tabs, and newlines preserved, ex- 
cept for the final newline which is 
dropped. The resulting text is placed in 
an anonymous temporary file which is given 
to the command as standard input. 
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> name 
>! name 
>& name 

>&! name The file name is used as standard output. 

If the file does not exist then it is 
created; if the file exists, it is trun- 
cated, and its previous contents is lost. 

If the variable noclobher is set, then the 
file must not already exist or it must be a 
character special file (e.g., a terminal or 
/dev/null) or an error results. This helps 
prevent accidental destruction of files. 
In this case, the ! forms can be used to 
suppress this check. 

The forms involving & route the diagnostic 
output into the specified file as well as 
the standard output. Name is expanded in 
the same way as < input filenames are. 

» name 
»& name 
»! name 

»&! name Uses file name as standard output like > 
but places output at the end of the file. 
If the variable noclobber is set, then it 
is an error for the file not to exist un- 
less one of the ! forms is given. Other- 
wise similar to >. 

If a command is run detached (followed by &), then the 
default standard input for the command is the empty file 
/dev/null. Otherwise the command receives the environ- 
ment in which the shell was invoked as modified by the 
input-output parameters and the presence of the command 
in a pipeline. Thus, unlike some previous shells, com- 
mands run from a file of shell commands have no access to 
the text of the commands by default; rather they receive 
the original standard input of the shell. Use the « 
mechanism to present inline data, so shell command scripts 
can function as components of pipelines and the shell can 
block-read its input. 

Diagnostic output may be directed through a pipe with 
the standard output. Simply use the form |& rather than 
just |. 
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Expressions 

A number of the built-in commands (to be described later) 
take expressions, in which the operators are similar to 
those of C, with the same precedence. These expressions 
appear in the @, exit, if, and while conraiands. The fol- 
lowing operators are available: 

1 1 && I * & == != <=>=<>«» 
+ -*/%!-() 

Here the precedence increases to the right, with the oper- 
ators: 

== and != 

<=, >=, <, and > 

« and » 

+ and - 

* / and % 

forming groups at the same level. The == and != operators 
compare their arguments as strings; all others operate on 
numbers. Strings which begin with 0 are considered octal 
numbers. Null or missing arguments are considered 0. The 
result of all expressions are strings, which represent 
decimal numbers. No two components of an expression can 
appear in the same word; they should be surrounded by 
spaces except when adjacent to components of expressions 
which are syntactically significant to the parser (& | < > 
( )). 

Also available in expressions as primitive operands are 
command executions enclosed in { and } and file enquiries 
of the form -I name where I is one of: 



r 


Read access 


w 


Write access 


X 


Execute access 


e 


Existence 


0 


Ownership 


z 


Zero size 


f 


Plain file 


d 


Directory 



The specified name is command and filename expanded, then 
tested to see if it has the specified relationship to the 
real user. If the file does not exist or is inaccessible. 
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all enquiries return false, i.e., 0. Command executions 
succeed, returning true, i.e., 1, if the command exits 
with status 0, otherwise they fail, returning false, i.e., 
0. If more detailed status information is required then 
the command should be executed outside of an expression 
and the variable status examined. 



Control Flow 

The shell contains a number of commands which can be used 
to control command files (shell scripts) and, in limited 
but useful ways, terminal input. These commands all oper- 
ate by forcing the shell to reread or skip in its input 
and, due to the implementation, restrict the placement of 
some of the commands. 

The foreach, switch, and while statements, as well as the 
if-then-else form of the if statement require that the 
major kejnvords appear in a single simple conmiand on an 
input line as shown below. 

If the shell's input is not seekable, the shell buffers up 
input whenever a loop is being read and performs seeks in 
this internal buffer to accomplish the rereading implied 
by the loop. (To the extent that this allows, backward 
goto commands will succeed on nonseekable inputs.) 



Built-in Commands 

Built-in commands are executed within the shell. If a 
built-in command occurs as any component of a pipeline 
except the last, then it is executed in a subshell. The 
following list describes the syntax and function of the 
built-in commands: 

alias 

alias name 

alias name wordlist 

The first form prints all aliases. The second form prints 
^J the alias for name. The final form assigns the specified 

wordlist as the alias of name; wordlist is command and 
filename substituted. The value for name is not allowed 
to be alias or unalias. 
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break Causes execution to resume after the end 

of the nearest enclosing foreach or while 
statement. The remaining commands on the 
current line are executed. Multi-level 
breaks are thus possible by writing them 
all on one line. 



breaksw Causes a break from a switch, resuming 

after the endsw. 



case label: A label in a switch statement as discussed 
below. 



cd 

cd name 
chdir 

chdir name 



continue 



Changes the shell's working directory to 
directory name. If no argument is given, 
changes to the home directory of the user. 
If name is not found as a subdirectory of 
the current directory (and does not begin 
with /, ./, or ../), then each component of 
the variable cdpath is checked to see if it 
has a subdirectory name. Finally, if all 
else fails but name is a shell variable 
whose value begins with /, then this is 
tried to see if it is a directory. 

Continues execution of the nearest enclos- 
ing while or foreach. The rest of the com- 
mands on the current line are executed. 



default: 



Labels the default case in a switch state- 
ment. The default should come after all 
case labels. 



echo wordlist The specified words are written to the 

shell's standard output. A \c causes the 
echo to complete without printing a new- 
line. A \n in wordlist causes a newline to 
be printed. Otherwise, the words are 
echoed, separated by spaces. 
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else 
end 
endif 

endsw See the description of the foreach, if, 

switch, and while statements below. 

exec command The specified command is executed in place 
of the current shell. 



exit 

exit (expr) The shell exits either with the value of 

the status variable (first form) or with 
the value of the specified expr (second 
form). 



foreach name (wordlist) 



The variable name is successively set to 
each member of wordlist and the sequence 
of commands between this command and the 
matching end are executed. (Both foreach 
and end must appear alone on separate 
lines. ) 



The built-in command continue may be used 
to continue the loop prematurely and the 
built-in command break to terminate it pre- 
maturely. When this command is read from 
the terminal, the loop is read once prompt- 
ing with ? before any statements in the 
loop are executed. 



glob wordlist Like echo but no \ escapes are recognized 
and words are delimited by null characters 
in the output. Useful for programs that 
wish to use the shell to filename expand a 
list of words. 



goto word The specified word is filename and com- 

mand expanded to yield a string of the form 
label. The shell rewinds its input as much 
as possible and searches for a line of the 
form label: possibly preceded by blanks or 
tabs. Execution continues after the speci- 
fied line. 
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history Displays the history event list. 

if {expr) command 

If the specified expression evaluates true, 
then the single command with arguments is 
executed. Variable substitution on command 
happens early, at the same time it does for 
the rest of the if command. The value for 
command must be a simple command, not a 
pipeline, a command list, or a parenthe- 
sized command list. Input/output redirec- 
tion occurs even if expr is false, when 
command is not executed. 



if (expr) then 

else if {expr2) then 

else 

endif 

If the specified expr is true, the conunands 
to the first then are executed; else if 
expr2 is true then the commands to the 
second then are executed, etc. Any number 
of else-if pairs are possible; only one 
endif is needed. The else part is likewise 
optional. (The words else and endif must 
appear at the beginning of input lines; the 
if-then clause must appear alone on its 
input line or after an else.) 



logout Terminates a login shell. The only way to 

log out if ignoreeof is set. 

nice 

nice +number 

nice command 

nice *numher command 

The first form sets the nice for this shell 
to 4. The second form sets the nice to the 
given number. The final two forms run 
command at priority 4 and number respec- 
tively. The superuser may specify negative 
niceness by using "nice -number 
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The command is always executed in a sub- 
shell, and the restrictions placed on com- 
mands in simple if statements apply. 



nohup 

nohup command The first form can be used in shell scripts 
to cause hangups to be ignored for the re- 
mainder of the script. The second form 
causes the specified command to be run with 
hangups ignored. Unless the shell is run- 
ning detached, nohup has no effect. All 
processes detached with & are automatically 
run with nohup. (Thus, nohup is not really 
needed. ) 



onintr 
onintr - 

onintr label Controls the action of the shell on inter- 
rupts. The first form restores the default 
action of the shell on interrupts: to ter- 
minate shell scripts or to return to the 
terminal command input level. The second 
form onintr - causes all interrupts to be 
ignored. The final form causes the shell 
to execute a goto label when an interrupt 
is received or a child process terminates 
because it was interrupted. 

In any case, if the shell is running de- 
tached and interrupts are being ignored, 
all forms of onintr have no meaning and 
interrupts continue to be ignored by the 
shell and all invoked commands. 



rehash Causes the internal hash table of the con- 

tents of the directories in the path vari- 
able to be recomputed. This is needed if 
new conmiands are added to directories in 
the path while you are logged in. This 
should only be necessary if you add com- 
mands to one of your own directories, or if 
a systems programmer changes the contents 
of one of the system directories. 
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repeat count command 

The specified command^ which is subject to 
the same restrictions as the command in the 
one-line if statement above, is executed 
count times. I/O redirection occurs ex- 
actly once, even if count is 0. 

set 

set name 

set name=word 

set name[index]=word 

set name=(woTdlist) 

The first form of the command shows the 
value of all shell variables. Variables 
that have other than a single word as value 
print as a parenthesized word list. The 
second form sets name to the null string. 
The third form sets name to the single 
word. The fourth form sets the indexth 
component of name to word; this component 
must already exist. The final form sets 
name to the list of words in wordlist. In 
all cases, the value is command and file- 
name expanded. These arguments may be 
repeated to set multiple values in a single 
set command. Note however, that variable 
expansion happens for all arguments before 
any setting occurs. 

setenv name value 

Sets the value of the environment variable 
name to be value, a single string. Useful 
environment variables are TERM, the type 
of your terminal and SHELL, the shell you 
are using. 

shift 

shift variable The members of argv are shifted to the 
left, discarding argv[l]. It is an error 
for argv not to be set or to have less than 
one word as value. The second form per- 
forms the same function on the specified 
variable. 
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source name The shell reads commands from name. 

Source commands may be nested; if they are 
nested too deeply, the shell may run out of 
file descriptors. An error in a source at 
any level terminates all nested source com- 
mands. Input during source commands is 
never placed on the history list. 



switch (string) 
case strl: 

breaksw 

default: 

breaksw 
endsw 

Each case label is successively matched 
against the specified string, which is 
first command and filename expanded. The 
file metacharacters *, ?, and [...] may be 
used in the case labels, which are variable 
expanded. If none of the labels match be- 
fore a default label is found, then the 
execution begins after the default label. 
Each case label and the default label must 
appear at the beginning of a line. The 
command breaksw causes execution to con- 
tinue after the endsw. Otherwise control 
may fall through case labels and default 
labels, as in C. If no label matches and 
there is no default, execution continues 
after the endsw. 



time 

time command With no argument, a sunmiary of time used 
by this shell and its children is printed. If 
arguments are given, the specified simple 
command is timed and a time summary as de- 
scribed under the time variable is printed. 
If necessary, an extra shell is created to 
print the time statistic when the command 
completes. 
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umask 

umask value The file creation mask is displayed (first 

form) or set to the specified value (second 
form). The mask is given in octal. Com- 
mon values for the mask are 002 giving all 
access to the group, and read and execute 
access to others; or 022 giving all access 
except no write access for users in the 
group or others. 

unalias pattern 

All aliases whose names match the specified 
pattern are discarded. Thus all aliases 
are removed by unalias *. It is not an 
error for nothing to match the unalias pat- 
tern. 

unhash Use of the internal hash table to speed 

location of executed programs is disabled. 

unset pattern All variables whose names match the speci- 
fied pattern are removed. Thus all vari- 
ables are removed by unset *; this has no- 
ticeably distasteful side-effects. It is 
not an error for nothing to be unset. 

wait All child processes are waited for. If the 

shell is interactive, an interrupt can dis- 
rupt the wait, at which time the shell 
prints names and process numbers of all 
children known to be outstanding. 

while iexpr) 

end While the specified expression evaluates 

non-zero, the commands between while and 
the matching end are evaluated. Use break 
and continue to terminate or continue the 
loop prematurely. While and end must ap- 
pear alone on their input lines. Prompting 
occurs here the first time through the loop 
as for the foreach statement if the input 
is a terminal. 
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@ 

@ name = expr 

@ name[index] = expr 

The first form prints the values of all the 
shell variables. The second form sets the 
specified name to the value of expr. If 
the expression contains <»>,&, or |, at 
least this part of the expression must be 
placed within ( ). The third form assigns 
the value of expr to the indexth argument 
of name. Both name and its indexth com- 
ponent must already exist. 

Assignment operators, such as *= and +=, 
are available as in C. The space separat- 
ing the name from the assignment operator 
is optional. Spaces are mandatory in sepa- 
rating components of expr which would 
otherwise be single words. 

Special postfix ++ and ~ operators incre- 
ment and decrement name respectively, 
e.g., @ 



Predefined Variables 

The following variables have special meaning to the shell. 
Of these, argv, childt home, path, prompt^ shell, and 
status are always set by the shell. Except for child and 
status, this setting occurs only at initialization; these 
variables will not then be modified unless done explicitly 
by the user. 

The shell copies the environment variable PATH into the 
variable path, and copies the value back into the environ- 
ment whenever path is set. Thus it is not necessary to 
worry about its setting other than in the file .cshrc, as 
inferior csh processes will import the definition of path 
from the environment. 

argv Set to the arguments of the shell, from 

this variable positional parameters are 
substituted, i.e., $1 is replaced by 
$argv[l]. 
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cdpath Gives a list of alternate directories 

searched to find subdirectories in cd com- 
mands. 



child The process number printed when the last 

command was forked with &. This variable 
is unset when this process terminates. 

echo Set when the -x command line option is 

given. Causes each command and its argu- 
ments to be echoed just before it is exe- 
cuted. For nonbuilt-in commands, all ex- 
pansions occur before echoing. Built-in 
commands are echoed before command and 
filename substitution, since these substi- 
tutions are then done selectively. 

histchars Can be assigned a two-character string. 

The first character is used as a history 
character in place of I, the second char- 
acter is used in place of the * substitu- 
tion mechanism. For example, set histchars 
= will cause the history characters to 
be comma and semicolon. 



history Can be given a numeric value to control the 

size of the history list. Any command that 
has been referenced in this many events 
will not be discarded. A history that is 
too large may run the shell out of memory. 
The last executed command is always saved 
on the history list. 

home The home directory of the user, initialized 

from the environment. The filename expan- 
sion of refers to this variable. 



ignoreeof If set, the shell ignores end-of-file from 

input devices that are terminals. This 
prevents a shell from accidentally being 
terminated by typing a Ctrl-d. 
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mail The files where the shell checks for mail. 

This is done after each command completion 
and will result in a prompt, if a specified 
interval has elapsed. The shell sends the 
message, "You have new mail," if the file 
exists with an access time not greater than 
its modify time. If the first word of the 
value of mail is numeric, it specifies a 
different mail checking interval, in sec- 
onds, than the default, which is 10 min- 
utes. If multiple mail files are speci- 
fied, the shell sends the message "New mail 
in name" when there is mail in the file 
name. 



noclobber As described in the section "Input/output," 

restrictions are placed on output redirec- 
tion to insure that files are not acci- 
dentally destroyed, and that » redirec- 
tions refer to existing files. 

noglob If set, filename expansion is inhibited. 

This is most useful in shell scripts that 
are not dealing with filenames, or after a 
list of filenames has been obtained and 
further expansions are not desirable. 

nonomatch If set, it is not an error for a filename 
expansion to not match any existing files; 
rather, the primitive pattern is returned. 
It is still an error for the primitive pat- 
tern to be malformed, i.e., echo [ still 
gives an error. 

path Each word of the path variable specifies a 

directory in which commands are to be 
sought for execution. A null word speci- 
fies the current directory. If there is no 
path variable, only full pathnames will 
execute. The usual search path is /bin, 
/usr/bin, and ., but this may vary from 
system to system. For the super-user the 
default search path is /etc, /bin and 
/usr/bin. A shell that is given neither 
the -c nor the -t option will normally hash 
the contents of the directories in the path 
variable after reading .cshre, and each 



24 



CSH(C) 



CSH(C) 



time the path variable is reset. If new 
commands are added to these directories 
while the shell is active, it may be neces- 
sary to use rehash or the commands may 
not be found. 



prompt 



shell 



The string which is printed before each 
command is read from an interactive ter- 
minal input. If a ! appears in the 
string, it will be replaced by the current 
event number unless a preceding \ is given. 
Default is % (or # for the super-user). 

The file in which the shell resides. This 
is used in forking shells to interpret 
files that have execute bits set, but which 
are not executable by the system. (See the 
section "Nonbuilt-In Command Execution" 
below.) Initialized to the system-dependent 
home of the shell. 



status 



The status returned by the last command. 
If it terminated abnormally, then 0200 is 
added to the status. Abnormal termination 
results in a core dump. Built-in commands 
that fail return exit status 1, all other 
built-in conmiands set status 0. 



time 



verbose 



Controls automatic timing of commands. If 
set, any command that takes more than this 
many CPU seconds will cause a line giving 
user, system, and real times and a utiliza- 
tion percentage (ratio of user plus system 
times to real time) to be printed when it 
terminates. 

Set by the -v command line option, causes 
the words of each command to be printed 
after history substitution. 



Nonbuilt-In Command Execution 

When a conmiand to be executed is found to not be a 
built-in command, the shell attempts to execute the com- 
mand via exec(S). Each word in the variable path names a 
directory from which the shell will attempt to execute the 
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command. If it is given neither a -c nor a -t option, the 
shell will hash the names in these directories into an 
internal table so that it will only try an exec in a di- 
rectory if there is a possibility that the command resides 
there. This greatly speeds command location when a large 
number of directories are present in the search path. If 
this mechanism has been turned off (with unhash), or if 
the shell was given a -c or -t argument, and in any case 
for each directory component of path which does not begin 
with a /, the shell concatenates with the given command 
name to form a pathname of a file which it then attempts 
to execute. 

Parenthesized commands are always executed in a subshell. 
Thus: 

(cd ; pwd) ; pwd 

prints the home directory; leaving you where you were 
(printing this after the home directory), while: 

cd ; pwd 

leaves you in the home directory. Parenthesized commands 
are most often used to prevent cd from affecting the cur- 
rent shell. 

If the file has execute permissions but is not an execut- 
able binary to the system, then it is assumed to be a file 
containing shell commands and a new shell is spawned to 
read it. 

If there is an alias for shell then the words of the alias 
will be prepended to the argument list to form the shell 
command. The first word of the alias should be the full 
pathname of the shell (e.g., $shell). Note that this is a 
special, late occurring case of alias substitution, and 
only allows words to be prepended to the argument list 
without modification. 
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Argument List Processing 

If argument 0 to the shell is -, then this is a login 
shell. The flag arguments are interpreted as follows: 

-c Commands are read from the (single) following argu- 
ment which must be present. Any remaining arguments 
are placed in argv. 

-e The shell exits if any invoked command terminates 
abnormally or yields a nonzero exit status. 

-f The shell will start faster, because it will neither 

search for nor execute commands from the file .cshrc 
in the user's home directory. 

-i The shell is interactive and prompts for its 

top-level input, even if it appears to not be a ter- 
minal. Shells are interactive without this option if 
their inputs and outputs are terminals. 

-n Commands are parsed, but not executed. This may aid 
in syntactic checking of shell scripts. 

-s Command input is taken from the standard input. 

-t A single line of input is read and executed. A \ may 
be used to escape the newline at the end of this line 
and continue onto another line. 

-V Causes the verbose variable to be set, with the ef- 
fect that command input is echoed after history sub- 
stitution. 

-X Causes the echo variable to be set, so that commands 
are echoed immediately before execution. 

-V Causes the verbose variable to be set even before 
.cshrc is executed. 

-X Causes the echo variable to be set even before .cshrc 
is executed. 

After the flag arguments have been processed, if arguments 
remain but none of the -c, -i, -s, or -t options were 
given, the first argument is taken as the name of a file 
of commands to be executed. The shell opens this file. 
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and saves its name for possible resubstitution by $0. 
Since on a typical system most shell scripts are written 
for the standard shell (see sh(C)), the C shell will exe- 
cute such a standard shell if the first character of a 
script is not a # (if the script does not start with a 
comment). Remaining arguments initialize the variable 
argv. 



Signal Handling 

The shell normally ignores quit signals. The interrupt 
and quit signals are ignored for an invoked command if the 
command is followed by &; otherwise the signals have the 
values that the shell inherited from its parent. The 
shell's handling of interrupts can be controlled by 
onintr. Login shells catch the terminate signal; other- 
wise this signal is passed on to children from the state 
in the shell's parent. In no case are interrupts allowed 
when a login shell is reading the file .logout. 



Files 



/etc/default/, cshrc 

/etc/default/, login 

/etc/default/, logout 

/bin/sh 

/tmp/sh* 
/dev/null 
/etc/passwd 

/etc/cshrc 



Read by each shell at the be- 
ginning of execution. 

Read by login shell, after 
.cshrc at login. 

Read by login shell, at 
logout. 

Shell for scripts not starting 

with a ff. 
Temporary file for «. 
Source of empty file. 
Source of home directories for 

name. 

Default file of automatically 
invoked conunands. 



Limitations 

Words can be no longer than 512 characters. The number 
of arguments to a command which involves filename expan- 
sion is limited to 1/6 number of characters allowed in an 
argument list, which is 10240, less the characters in the 
environment. Also, command substitutions may substitute 
no more characters than are allowed in an argument list. 
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To detect looping, the shell restricts the number of alias 
substitutions on a single line to 20. 



See Also 

access(S), a.out(F), environ(M), exec(S), fork(S), 
pipe(S), signal(S), umask(S), wait(S) 
User's Guide 



Credit 

This utility was developed at the University of California 
at Berkeley and is used with permission. 



Notes 

Built-in control structure commands like foreach and while 
cannot be used with |, &, or ;. 

Commands within loops, prompted for by ?, are not placed 
in the history list. 

It is not possible to use the colon (:) modifiers on the 
output of command substitutions. 

Csh attempts to import and export the PATH variable for 
use with regular shell scripts. This only works for sim- 
ple cases, where the PATH contains no conmiand characters. 

This version of csh does not support or use the process 
control features of the 4th Berkeley Distribution. 
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Name 

csplit - Splits files according to context. 



Syntax 

csplit [-f prefix] [-k] [-s] file argl [ ... argn ] 



Description 

Csplit reads file and separates it into n+1 sections, de- 
fined by the arguments argl. ..argn. By default the sec- 
tions are placed in xxOO...xxn (n may not be greater 
than 99). These sections get the following pieces of 
file: 

00: From the start of file up to (but not including) the 
line referenced by argl. 

01: From the line referenced by argl up to the line re- 
ferenced by arg2 



n: From the line referenced by argn to the end of file. 
The options are: 

-f prefix If the -f option is used, the created files are 
named prefixOO...prefixn. The default is 
xx00...xxn. 

-k Csplit normally removes created files if an 

error occurs. If this option is present, csplit 
leaves previously created files intact. 

-s Csplit normally prints the character counts for 

each file created. If this option is present, 
csplit suppresses the printing of all character 
counts. 

The arguments {argl... argn) can be a combination of the 
following: 
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A file is to be created for the section from the 
current line up to (but not including) the line 
containing the regular expression rexp. The 
current line becomes the line containing rexp. 
This argument may be followed by an optional + 
or - some number of lines (e.g., /Page/-5). 

This argument is the same as /rexp/, except that 
no file is created for the section. 

A file is to be created from the current line up 
to (but not including) Inno. The current line 
becomes Inno. 

Repeat argument. This argument may follow any 
of the above arguments. If it follows a rexp 
argument, that argument is applied num more 
times. If it follows Inno, the file will be 
split every Inno lines (num times) from that 
point. 

Enclose all rexp arguments that contain blanks or other 
characters meaningful to the shell in the appropriate quo- 
tation marks. Regular expressions may not contain em- 
bedded newline characters. Cspllt does not affect the 
original file; it is the user's responsibility to remove it. 



Examples 

csplit -f cobol file Vprocedure division/' /par5./ /pari 6./ 

This example creates four files, cobol00...cobol03. 
After editing the "split" files, they can be recombined 
as follows: 

cat cobol0[0-3] > file 

Note that this example overwrites the original file. 
espUt -k file 100 {99} 



/rexp/ 

%rexp% 
Inno 

{num} 
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This example would split the file at every 100 lines, up 
to 10,000 lines. The -k option causes the created files 
to be retained if there are less than 10,000 lines; how- 
ever, an error message would still be printed. 

cspUt -k prog.c •%main(%' V*}/+r {20} 

Assuming that prog.c follows the normal C coding conven- 
tion of ending routines with a } at the beginning of the 
line, this example will create a file containing each sep- 
arate C routine (up to 21) in prog.c. 



See Also 

ed(C), regex(S), sh(C) 



Diagnostics 

Self-explanatory, except for: 

arg - out of range 

which means that the given argument did not reference a 
line between the current position and the end of the file. 
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Name 

ct - Spawns getty to a remote terminal. 



Syntax 

ct [-h] [-v] [-wn] [-xn] [-sspeed] telno ... 



Description 

Ct dials the phone number of a modem that is attached to 
a terminal, and spawns a getty process to that terminal. 
Telno is a telephone number, with equal signs for secon- 
dary dial tones and minus signs for delays at appropriate 
places. If you specify more than one telephone number, ct 
tries each in succession until one answers; this is useful 
for specifying alternate dialing paths. 

Ct tries each line in the file /usr/lib/uucp/Devices until 
it finds an available line with appropriate attributes or 
runs out of entries. If there are no free lines, ct asks 
if it should wait for one, and if so, for how many minutes 
it should wait before it gives up. Ct continues to try to 
open the dialers at one-minute intervals until the speci- 
fied limit is exceeded. 



Options 

-xn Produces a detailed output of the program execution 
on stderr (used for debugging). The debugging level, 
n, is a single digit; -x9 is the most useful value. 

-wn Overrides dialogue, n is the maximum number of min- 
utes that ct is to wait for a line. 

-h Prevents ct from hanging up current line to allow 
that line to answer the incoming call (the default is 
to hang up). Waits for the termination of the speci- 
fied ct process before returning control to the 
user's terminal. 

-V Sends a running narrative to the standard error out- 
put stream. 
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-s Sets the data rate; speed is the baud rate. The de- 
fault rate is 1200. 

If there is already an active getty(M) or uugetty(M) 
running on the dial-out port prior to invoking ct, ct will 
establish the connection and exit, allowing the running 
getty(M) or uugetty(M) to print the "login:" prompt on 
the destination terminal. The connection is terminated 
after the user on the destination terminal logs out. 

On the other hand, if the dial-out port is disabled, ct 
spawns a new getty(M) on the port after establishing 
connection, and waits for the user on the destination 
terminal to log out. 

After the user logs out, ct prompts. 



Reconnect? 



If the response begins with the letter n or there is no 
response in 20 seconds, the line is dropped; otherwise, 
getty(M) will be started again and the login: prompt will 
be printed. 

To log out properly, type KWiiBiB . 

Of course, the destination terminal must be attached to a 
modem that can answer the telephone. 



Files 



/usr/lib/uucp/Devices 
/usr/adm/ctlog 



See Also 



cu(C), login(C), uucp(C), getty(M), uugetty(M) 
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Name 

ctags - Creates a tags file. 



Syntax 

ctags [ -u ] [ -w ] [ -X ] name ... 



Description 

Ctags makes a tags file for vi(C) from the specified C 
sources. A tags file gives the locations of specified 
objects (in this case functions) in a group of files. Each 
line of the tags file contains the function name, the file 
in which it is defined, and a scanning pattern used to 
find the function definition. These are given in separate 
fields on the line, separated by blanks or tabs. Using 
the tags file, vi can quickly find these function defini- 
tions. Options are: 

-u Causes the specified files to be updated in tags; 
that is, all references to them are deleted, and the 
new values are appended to the file. (Note: this 
option is implemented in a way which is rather slow; 
it is usually faster to simply rebuild the tags 
file.) 

-w Suppresses warning diagnostics. 

-X Produces a list of function names, the line number 
and file name on which each is defined, as well as 
the text of that line and prints this on the standard 
output. With the -x option no tags file is created. 
This is a simple index which can be printed out as an 
off-line readable function index. Files whose name 
ends in .c or .h are assumed to be C source files and 
are searched for C routine and macro definitions. 

The tag main is treated specially in C programs. The tag 
formed is created by prepending M to the name of the file, 
with a trailing .c removed, if any, and leading pathname 
components also removed. This makes use of ctags prac- 
tical in directories with more than one program. 
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Files 

tags Output tags file 

See Also 

ex(C), vi(C) 

Credit 

This utility was developed at the University of California 
at Berkeley and is used with permission. 
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Name 

cu - Calls another UNIX system. 



Syntax 

cu [-sspeed] [-lline] [-h] [-t] [-d] [-o | -e] [-n] telno 

cu [ -s speed ] [ -h ] [ -d ] [ -o | -e ] -1 line 

cu [-h] [-d] [-0 I -e] systemname 



Description 

Cu calls up another UNIX system, a terminal, or possibly 
a non-UNIX system. It manages an interactive conversa- 
tion with possible transfers of ASCII files. 



NOTE 

Before you run cu, set up the serial port as: 
xtty ixon ixoff iflow oflow. See xtty(C) for 
an explanation of these flags. 



Cu accepts the following options and arguments: 

-sspeed Specifies the transmission speed (300, 

1200, 2400, 4800, 9600). The default value 
is "Any" speed which will depend on the 
order of the lines in the 
/usr/lib/uucp/Devices file. Most modems 
are either 300 or 1200 baud. Directly con- 
nected lines may be set to a speed higher 
than 1200 baud. 

-Ih'ne Specifies a device name to use as the com- 

munication line. This can be used to over- 
ride the search that would otherwise take 
place for the first available line having 
the right speed. When the -1 option is 
used without the -s option, the speed of a 
line is taken from the Devices file. When 
the -1 and -s options are both used to- 
gether, cu will search the Devices file to 
check if the requested speed for the re- 
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) 

-h 
-t 

/ -d 
-o 

-n 

-e 

telno 

systemname 



quested line is available. If so, the con- 
nection will be made at the requested 
speed; otherwise an error message will be 
printed and the call will not be made. The 
specified device is generally a directly 
connected asynchronous line (e.g., 
/dev/ttynn) in which case a telephone num- 
ber (telno) is not required. The specified 
device need not be in the /dev directory. 
If the specified device is associated with 
an auto dialer, a telephone number must be 
provided. Use of this option with system- 
name rather than telno will not give the 
desired result (see systemname below). 

Emulates local echo, supporting calls to 
other computer systems which expect ter- 
minals to be set to half-duplex mode. 

Used to dial an ASCII terminal which has 
been set to auto answer. Appropriate map- 
ping of carriage-return to carriage-return- 
line-feed pairs is set. 

Causes diagnostic traces to be printed. 

Designates that odd parity is to be gener- 
ated for data sent to the remote system. 

For added security, will prompt the user to 
provide the telephone number to be dialed 
rather than taking it from the command 
line. 

Designates that even parity is to be gener- 
ated for data sent to the remote system. 

When using an automatic dialer, the argu- 
ment is the telephone number with equal 
signs for secondary dial tone or minus 
signs placed appropriately for delays of 4 
seconds. 

A UUCP system name may be used rather 
than a telephone number; in this case, cu 
will obtain an appropriate direct line or 
telephone number from 
/usr/lib/uucp/Systems. 
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NOTE 

The systemname option should not be used in 
conjunction with the -1 and -s options as cu 
will connect to the first available line for 
the system name specified, ignoring the re- 
quested line and speed. 



After making the connection, cu runs as two processes: 
the transmit process reads data from the standard input 
and, except for lines beginning with passes it to the 
remote system; the receive process accepts data from the 
remote system and, except for lines beginning with 
passes it to the standard output. Normally, an automatic 
DC3/DC1 protocol is used to control input from the remote 
system so the buffer is not overrun. Lines beginning with 
' have special meanings. 



The transmit process interprets these user-initiated com- 
mands: 



Terminate the conversation. 

'! Escape to an interactive shell on the 

local system. 

'Icmd.., Run cmd on the local system (via sh 

-c). 

'$cmd... Run cmd locally and send its output to 

the remote system. 

'%cd Change the directory on the local sys- 

tem. Note: "led will cause the com- 
mand to be run by a sub-shell, prob- 
ably not what was intended. 



"■^take from [ to ] Copy file from (on the remote system) 
to file to on the local system. If to 
is omitted, the from argument is used 
in both places. 
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~%put from [ to ] Copy file from (on local system) to 
file to on remote system. If to is 
omitted, the from argument is used in 
both places. 

For both '%take and put commands, as 
each block of the file is transferred, 
consecutive single digits are printed 
to the terminal. 

Send the line "line to the remote 
system. 

Transmit a BREAK to the remote sys- 
tem (which can also be specified as 
-%b). 

Toggle the -d debugging option on or 
off (which can also be specified as 
-%d). 

Print the values of the termio struc- 
ture variables for the user's terminal 
(useful for debugging). 

Print the values of the termio struc- 
ture variables for the remote conmiuni- 
cation line (useful for debugging). 

Toggle between DC3/DC1 input control 
protocol and no input control. This 
is useful in case the remote system is 
one which does not respond properly 
to the DC3 and DCl characters. 

The receive process normally copies data from the remote 
system to its standard output. Internally the program 
accomplishes this by initiating an output diversion to a 
file when a line from the remote begins with *>. 

Data from the remote is diverted (or appended, if » is 
used) to file on the local system. The trailing "> marks 
the end of the diversion. 

The use of *%put requires stty(C) and cat(C) on the remote 
side. It also requires that the current erase and kill 
characters on the remote system be identical to these cur- 



~~ line 
~%break 

~%debug 

"t 

"'%nostop 
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rent control characters on the local system. Backslashes 
are inserted at appropriate places. 

The use of "^take requires the existence of echo(C) and 
cat(C) on the remote system. Also, tabs mode (see 
stty(C)) should be set on the remote system if tabs are to 
be copied without expansion to spaces. 

When cu is used on system X to connect to system Y and 
subsequently used on system Y to connect to system Z, com- 
mands on system Y can be executed by using ~~. Executing 
a tilde command reminds the user of the local system 
uname. For example, uname can be executed on Z, X, and 
Y as follows: 

uname 
Z 

" [X] ! uname 
X 

"~[Y]!uname 
Y 

In general, ~ causes the command to be executed on the 
original machine ~~ causes the command to be executed on 
the next machine in the chain. 



Examples 

To dial a system whose telephone number is 9 (201) 
555-1212 using 1200 baud (where a dialtone is expected 
after the 9): 

cu -sl200 9=12015551212 

If the speed is not specified, "Any" is the default value. 
To login to a system connected by a direct line: 
cu -1 /dev/ttynn 

or 

cu -1 ttynn 
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To dial a system with the specific line and a specific 
speed: 

cu -S1200 -1 ttynn 

To dial a system using a specific line associated with an 
auto dialer: 

cu -1 culnn 9=12015551212 

To use a system name: 
cu systemname 



Files 

/usr/lib/uucp/ Systems 
/usr/lib/uucp/Devices 
/usr/spool/locks/LCK. . (tty-device) 



See Also 

cat(C), echo(C), stty(C), uucp(C), uname(C) 



Diagnostics 

Exit code is zero for normal exit, otherwise, one. 



Notes 

The cu command does not do any integrity checking on data 
it transfers. Data fields with special cu characters may 
not be transmitted properly. Depending on the interconnec- 
tion hardware, it may be necessary to use a to termi- 
nate the conversion even if stty 0 has been used. Non- 
printing characters are not dependably transmitted using 
either the "^put or ''%take commands. Cu with some modems 
will not return a login prompt immediately upon connec- 
tion. A carriage return will return the prompt. 

There is an artificial slowing of transmission by cu dur- 
ing the ~%put operation so that loss of data is unlikely. 

Cu and csh(C) are not compatible. 
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Name 

date - Prints and sets the date. 



Sjnitax 

date [-cms] [ mmddhhmm[yy] ] [ +format ] 



Description 

If no argument is given, or if the argument begins with +, 
the current date and time are printed. If an argument is 
given, the current date is set. Arguments are 

mm= the month number 
dd = the day number in the month 
hh = the hour number (24-hour clock) 
mm= the minute number 

yy = the last two digits of the year (optional) 
For example, 

date 10080045 

sets the date to Oct 8, 12:45 AM. The current year is the 
default if no year is given. The system operates in GMT 
(Greenwich Mean Time). Date takes care of the conversion 
to and from local standard and daylight time. To change 
the time zone, see the TZ option of environ(C). 

To change the time zone, 

• Bourne shell (sh) 

Insert the following in /etc/profile: 

TZ=timezone 
export TZ 

• C shell (csh) 

Insert the following in /etc/cshrc: 
f 

setenv TZ timezone 
Timezone is either PST, MST, CST, or EST. 
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If the argument begins with +, the output of date is un- 
der the control of the user. The format for the output is 
similar to that of the first argument to printf(S). All 
output fields are of fixed size (zero padded, if neces- 
sary). Each field descriptor is preceded by a percent 
sign (%) and will be replaced in the output by its corres- 
ponding value. A single percent sign is encoded by doub- 
ling the percent sign, i.e., by specifying All 
other characters are copied to the output without change. 
The string is always terminated with a newline character. 



Options 

-c Prints the current date and time from the hardware 
real-time clock; date -c mmddhhmmlyy] sets the real- 
time clock. 

-m Updates the year on the hardware real-time clock if 
it is January 1, and makes adjustments to the real- 
time clock if it is February 29 in a leap year. 
These dates are not automatically incremented. Be 
sure to use this option after midnight. The -m op- 
tion checks for January 1 or February 29, and then 
updates the hardware real-time clock if necessary. 
For the -m option to work correctly, the software 
clock and the hardware clock should be within twelve 
hours of one another. Use cron(C) to execute date -m 
each day. 

-s Sets (synchronizes) the system (i.e., software) clock 
to the current time and date from the hardware real- 
time clock. 

The operating system normally uses only the system 
(software) clock. It uses the hardware real-time clock 
only with the date command. 
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Field Descriptors: 



a 


Abbreviated weekday (Sun to Sat) 


d 


Day of month (01 to 12) 


D 


Date as mm/dd/yy 


h 


Abbreviated month (Jan to Dec) 


H 


Hour (00 to 23) 


m 


Month of year (01 to 12) 


j 


Julian date (001 to 366) 


M 


Minute (00 to 59) 


n 


Inserts a newline character 


r 


Time in AM/PM notation 


S 


Second (00 to 59) 


T 


Time as HH:MM:SS 


t 


Inserts a tab character 


w 


Day of the week (Sunday = 0) 


y 


Last 2 digits of the year (00 to 99) 



Example 

If you t57pe 

date •+DATE:%m/W%y%nTIME:%H:%M:%S' 
the output is: 



DATE: 04/01/85 
TIME: 14: 45: 05 



Related Commands 

asktime(C) 



Files 



/usr/adm/wtmp 



To record time-setting 
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Diagnostics 

no permission = you aren't the super-user when changing 
the date. 

bad conversion = incorrect syntax used. 

bad format character = incorrect field descriptor used. 
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Name 

dc - Desk calculator. 



Sjmtax 

dc [ file ] 



Description 

Dc is an arbitrary precision arithmetic package. Ordi- 
narily it operates on decimal integers, but one may speci- 
fy an input base, output base, and a number of fractional 
digits to be maintained. (See bc(C), a preprocessor for 
dc that provides infix notation and a C-like syntax that 
implements functions. Be also provides reasonable control 
structures for programs.) The overall structure of dc is a 
stacking (reverse Polish) calculator. If an argument is 
given, input is taken from that file until its end, then 
from the standard input. The following constructions are 
recognized: 

number The value of the number is pushed on the stack. 
A number is an unbroken string of the digits 
0-9. It may be preceded by an underscore (_) to 
input a negative number. Numbers may contain 
decimal points. 

+ - / * % ^ 

The top two values on the stack are added (+), 
subtracted (-), multiplied (*), divided (/), re- 
maindered (%), or exponentiated ("). The two 
entries are popped off the stack; the result is 
pushed on the stack in their place. Any frac- 
tional part of an exponent is ignored. 

sx The top of the stack is popped and stored into a 

register named x, where x may be any character. 
If the s is capitalized, x is treated as a stack 
and the value is pushed on it. 
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he The value in register x is pushed on the stack. 

The register x is not altered. All registers 
start with zero value: If the 1 is capitalized, 
register x is treated as a stack and its top 
value is popped onto the main stack. 

d The top value on the stack is duplicated. 

p The top value on the stack is printed. The top 

value remains unchanged. 

P Interprets the top of the stack as an ASCII 

string, removes it, and prints it. 

f All values on the stack are printed: 

q Exits the program. If executing a string, the 

recursion level is popped by two. 

Q Exits the program. The top value on the stack 

is popped and the string execution level is 
popped by that value. 

X Treats the top element of the stack as a charac- 

ter string and executes it as a string of do 
commands. 

X Replaces the number on the top of the stack with 

its scale factor. 

[...] Puts the bracketed ASCII string onto the top of 

the stack. 

<x>x=x The top two elements of the stack are popped 
and compared. Register x is evaluated if they 
obey the stated relation. 

V Replaces the top element on the stack by its 

square root: Any existing fractional part of 
the argument is taken into account, but other- 
wise the scale factor is ignored. 

! Interprets the rest of the line as an operating 

system conmiand. 
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c All values on the stack are popped. 

i The top value on the stack is poped and used as 

the number radix for further input. 

I Pushes the input base on the top of the stack. 

o The top value on the stack is popped and used as 

the number radix for further output. 

O Pushes the output base on the top of the stack. 

k The top of the stack is popped, and that value 

is used as a non-negative scale factor: the 
appropriate number of places are printed on out- 
put, and maintained during multiplication, divi- 
sion, and exponentiation. The interaction of 
scale factor, input base, and output base will 
be reasonable if all are changed together. 

z The stack level is pushed onto the stack. 

Z Replaces the number on the top of the stack with 

its length. 

? A line of input is taken from the input source 

(usually the terminal) and executed. 

;: Used by bc(C) for array operations: 



Example 

This example prints the first ten values of n!: 

[ la 1 +dsa*pla 1 0 >y ] sy 

Osal 

lyx 



See Also 
bc(C) 
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Diagnostics 

X is unimplemented 

Where x is an octal number. 

stack empty 

Not enough elements on the stack to do what was 
asked. 

Out of space 

The free list is exhausted (too many digits). 

Out of headers 

Too many numbers being kept around. 

Out of pushdown 

Too many items on the stack. 

Nesting Depth 

Too many levels of nested execution. 
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Name 

dd - Converts and copies a file. 



Syntax 

dd [option=value] ... 



Description 

The dd command copies the specified input file to the spe- 
cified output with possible conversions. The standard 
input and output are used by default. The input and out- 
put block size may be specified to take advantage of raw 
physical I/O. 

Options Values 

if=/i7c Input file name; standard input is default 

of=file Output file name; standard output is de- 

fault 

ibs=n Input block size n bytes (default 512) 

obs=n Output block size (default 512) 

bs=n Set both input and output block size, 

superseding lbs and obs; also, if no con- 
version is specified this is particularly 
efficient since no copy need be done 

cbs=n Conversion buffer size 

skip=n Skip n input records before starting copy 

files=n Copy n files from (tape) input 

seek=n Seek n records from beginning of output 

file before copying (the output file is 
truncated first) 

count=n Copy only n input records 
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conv=ascii 



Convert EBCDIC to ASCII 



conv=ebcdic 



Convert ASCII to EBCDIC 



conv=ibm 



Slightly different map of ASCII to 
EBCDIC 



conv=lcase 



Map alphabetics to lower case 



conv=ucase 



Map alphabetics to upper case 



conv=swab 



Swap every pair of bytes 



conv=noerror 



Do not stop processing on an error 



conv=sync 



Pad every input record to lbs 



conv="... , ..." Several comma-separated conversions 

Where sizes are specified, a number of bytes is expected. 
End a number with k, b, or w to specify multiplication by 
1024, 512, or 2 respectively; separate a pair of numbers 
with X to indicate a product. 

The cbs option is used only if ASCII or EBCDIC conversion 
is specified. In the former, case characters are placed 
into the conversion buffer, converted to ASCII, and trail- 
ing blanks trimmed and newline added before sending the 
line to the output. In the latter, case ASCII characters 
are read into the conversion buffer, converted to EBCDIC, 
and blanks added to make up an output record of size chs. 

The ASCII /EBCDIC conversion tables are taken from the 256 
character standard in the CACM Nov, 1968. The ibm conver- 
sion corresponds better to certain IBM print train conven- 
tions. 

Newlines are inserted only on conversion to ASCII; padding 
is done only on conversion to EBCDIC. These should be 
separate options. 

After completion, dd reports the number of whole and par- 
tial input and output blocks. 
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Examples 

For example, to read an EBCDIC tape blocked ten 80-byte 
EBCDIC card images per record into the ASCII file x: 

dd if=/dev/rct of=x ibs=800 cbs=80 conv=ascii,lcase,sync 

Note the use of raw mag tape. Dd is especially suited to 
I/O on the raw physical devices because it allows reading 
and writing in arbitrary record sizes. 

To skip over a file before copying from magnetic tape, 
type the following: 

(dd of=/dev/null; dd of=x) </dev/rct 



Related Commands 
cp(C), cat(C) 



Notes 

The cbs value must be zero if no block conversion is re- 
quested. 

The last block of data is not written to tape (/dev/rct) 
or floppy if there is not enough data to fill that block. 
Therefore, use the conv=sync option to make sure the last 
block is written. 

If you are using raw I/O on the file processor, use a 
block size that is a mulitiple of 512 bytes. 

It's best to use the same block size (used when storing 
data) when you retrieve data. 



Error Messages 

f+p records in(out): numbers of full and partial records 
read(written) 

See "Operating System Error Messages" in the Operations 
Guide. 



3 



DEVINFO(C) DEVINFO(C) 



Name 

devinfo - Displays device information. 

¥ 

Syntax 

/etc/devinfo [ -jp ] [ -bhoard ] [ -cchan ] [ -ttype ] 



Description 

Use devinfo to display information about certain devices 
in the system. These devices are usually related to com- 
munications (e.g., SIO and Multidrop boards). The devinfo 
information comes from the /etc/sysdisp file, if it ex- 
ists, otherwise from the sysconf(S) system call. 

The command without any arguments prints information about 
each board currently in the system that is associated with 
tty devices. For example. 



Board Name Major Prefix Filrst tast 

0 Multidrop 10 tty /dev/COnsOle /dev/tty63 

1 SIO 5 tty /dev/tty64 /dev/tty73 

2 SIO 5 tty /dev/tty74 /dev/tty83 



The options are: 

-bboard Displays the type of the specified board as a 
decimal code. For example, the code for a 
Multidrop- type board is a 4 and for an SIO- type 
board is 3. 

-cchan Displays the tty name associated with channel 
chan on the board specified by the -b option. 

-j Gives the subjumpering sequence of the board 

specified by the -b option. 

-p Displays the entire sysdisp entry. 
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-ttype Specifies a sysdisp entry for boards with a type 
code of type. Must be used with the -p option. 

For example, 

devinfo -bl -c8 

displays /dev/tty72, which is the tty name associated with 
channel 8 on the board in slot 1. 

devinfo -bl 

displays 3, which is the board type as a decimal code. 
For more information, see /usr/include/sys/bootinfo.h and 
the sysconf system call. 



Files 

/etc/sysdisp Describes all possible board types 



See Also 

sysconf (C), sysconf (S) 



Notes 

If devinfo can't obtain the current board map (the 
sysconf (S) system call was introduced at the same time 
that Multidrop was added), it assumes that the current 
system configuration consists of four SIO boards. 

As explained in sysconf(C), on an Altos 386 Series 1000, 
an SIO board is reported as a Multidrop. Also, multiple 
SIOs are reported as only one Multidrop on these systems. 

However, the range of tty ports reported in "First" and 
"Last" is still accurate. For example, a 386 Series 1000 
with three SIOs would be reported as shown with only 
one Multidrop board and 24 ports: 



Board Name Major Prefix First Last 

0 multidrop 10 tty ttyOO tty23 
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Name 

devnm - Identifies device name on which files reside. 

Syntax 

/etc/devnm name... 

Description 

Devnm identifies the special file associated with the 
mounted file system where the argument name resides. 

Examples 

Be sure to type full pathnames as in this example: 

/etc/devnm /usr 
If /dev/hdOb is mounted on /usr, this produces: 

M0b /usr 

Files 

/dev/* device names 

/etc/mnttab 
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Name 

diff - Compares two text files. 



Syntax 

diff [ -befh ] filel file2 



Description 

Diff tells what lines must be changed in two files to 
bring them into agreement. If filel {file2) is -, the 
standard input is used. If filel {file2) is a directory, 
then a file in that directory with the name file2 {filel) 
is used. Normal output line format is: 

nl a nSfTid 
nl,n2 d n3 
nl,n2 c n3,n4 

These lines resemble ed(C) commands to convert filel into 
file2. The numbers after the letters pertain to file2. 
In fact, by exchanging a for d and reading backward you 
can ascertain how to convert file2 into filel. As in ed, 
identical pairs, where nl = n2 or n3 = n4, are abbreviated 
as a single number. 

Following each of these lines come all the lines that are 
affected in the first file flagged by <, then all the 
lines that are affected in the second file flagged by >. 

Except in rare circumstances, diff finds the smallest suf- 
ficient set of file differences. The options are: 

-b Causes trailing spaces and tabs to be ignored and 
other strings of spaces to compare equally. 

-e Produces a script of a, c, and d commands for the 
editor ed, which will recreate file2 from filel. 

-f Produces a similar script, not useful with ed, in the 
opposite order. 
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In connection with -e, the following shell procedure helps 
maintain multiple versions of a file: 

(shift; cat $*; echo 'l,$p') | ed - $1 

which performs a set of editing operations on an original 
ancestral file. It combines the sequence of ed scripts 
given as all command line arguments except the first. 
These scripts are presumed to be created with diff in the 
order given on the conmiand line. The set of editing oper- 
ations is then piped as an editing script to ed where all 
editing operations are performed on the ancestral file 
given as the first argument on the command line. The 
final version of the file is then displayed. Only an an- 
cestral file ($1) and a chain of version-to-version ed 
scripts ($2,$3,...) made by diff need be on hand. 

-h Produces a fast, but less rigorous job. It works 

only when changed stretches are short and well sepa- 
rated, but it also works on files of unlimited 
length. The -e and -f options cannot be used with 
the -h option. 



Files 

/tmp/d????? 
/usr/lib/diffh for -h 



See Also 

cmp(C), comm(C), ed(C) 



Diagnostics 

Exit status: 0 = no differences, 1 = differences, 2 = 
errors. 

Missing newline at end of file X. The last line of file X 
did not have a newline. If the lines are different, they 
will be flagged and output; although the output will seem 
to indicate they are the same. 
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Notes 

Editing scripts produced under the -e or -f options do not 
always work correctly on lines consisting of a single per- 
iod (.). 
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Name 

diffS - Compares three files. 



Syntax 

diff3 [ -8x3 ] filel fileZ fileS 



Description 

DiffS compares three versions of a file, and publishes 
disagreeing ranges of text flagged with these codes: 

==== All three files differ 

====1 Filel is different 

====2 File2 is different 

====3 Files is different 

The type of change suffered in converting a given range of 
a given file to some other range is indicated in one of 
these ways: 

/ : nl a Text is to be appended after line number 

nl in file /, where / = 1, 2, or 3. 

f : nl , n2 c Text is to be changed in the range from 
line nl to line n2. If nl = n2, the range 
may be abbreviated to nJ. 

The original contents of the range follows immediately 
after a c indication. When the contents of two files are 
identical, the contents of the lower-numbered file is sup- 
pressed. 

The options are: 

-e Publishes a script for the editor, ed(C), that will 
incorporate into filel all changes between file2 and 
files, i.e., the changes that normally would be 
flagged with "====" and "====3." 
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-X Produces a script to incorporate changes flagged with 
"==== " 

-3 Produces a script to incorporate changes flagged with 
"====3." 

The following command applies an editing script to filel: 
(cat script; echo 'l,$p') | ed - filel 

Files 

/tmp/d3* 
/usr/lib/diff3prog 

See Also 

diff(C) 

Notes 

The -e option does not work properly for lines consisting 
of a single period. 

The input file size limit is 64K bytes. 



2 



DIGEST(C) 



DIG EST (C) 



Name 



digest - Creates menu system(s) for the Business Shell. 



Syntax 



digest [ options ] menufile ... 



Description 



Digest is used to create a menu system for use by the 
Business Shell (bsh(C)). This program is also used to 
modify an existing menu system. 

One or more menu systems may be created using the options 
described below. 



-h or -q Displays an informative summary of the available 
options and defaults. 

-1 number Checks for menus longer than number lines in 
length. The default value is 25 if none is 
specified. This is the correct maximum number 
for a conventional 24-line CRT screen. In gen- 
eral, number should be one larger than the 
length of the screen area (as defined by "11" in 
termcap) for the terminal to be used. The user 
is responsible for ensuring that the width of a 
menu will fit on the terminal(s) he uses. 
Bsh(C) will truncate lines that are too wide 
(without issuing a warning message). 



-m Multiple menu systems: For each menu file 

(which must be a directory), this option pro- 
duces a separate menu system. The names for 
each menu system are created by suffixing ".bin" 
to the menu file name. 



-o file The digested output is sent to the named file. 

By convention, a digested menu system file name 
should end with a ".bin" suffix. 
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-s menu The starting menu for the generated menu system 
is the one specified. (This option doesn't make 
much sense if used with the -m option.) If no 
starting menu is specified, the alphabetically 
first menu name is used for each menu system. 

-V Verbose: echo menu names as they are processed. 



A menufile may contain one or more menus or directories 
containing menus. Digest will recursively process all 
menus within a directory structure. 

Note that the -m and -o options are mutually exclusive. 
The -m option indicates that each menu is to produce a 
separate ".bin" file: -o indicates that a single output 
file is to be produced with the name given. 

The default output file is menul. bin if none is specified 
via the -o option, where menul is the first menu file 
name. 



The recommended way to create a menu system is to create 
a tree of directories containing the various portions of the 
system. Each subtree contains all the menus related to a 
given subject. For example, a primary menu (directory) 
can be created for system management functions and sub- 
sidiary menus can be placed beneath (within) the directory 
for each of the individual system management functions or 
function areas. Help menus may be placed wherever appro- 
priate in the structure. 



Example 



Assuming that /usr/lib/menusys contains the following 
files for the Business Shell menu system: 



Backup Execute Help? SysAdmln 

Backup? Execute? Mail SysAdmin? 

Commands? FloppyBackup Mail? TapeBackup 

Dir FloppyBackup? Start Tape Backup? 

Dir? Help Start? 



Then the following command will make a menu system file: 



digest -o /etc/menusys.bin -s Start /usr/lib/menusys 
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See Also 

bsh{C), menus(M), termcap(M) 

Diagnostics 

The diagnostics produced by digest are intended to be self 
explanatory. 
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Name 

dircmp - Compares directories. 



Sjnitax 

dircmp [ -d ] [ -s ] [ -wn ] dirl dir2 



Description 

Dircmp examines dirl and dir2 and generates tabulated in- 
formation about the contents of the directories. Listings 
of files that are unique to each directory are generated 
in addition to a list that indicates whether the files 
common to both directories have the same contents. 

The options are: 

-d Performs a full diff(C) on each pair of like-named 
files if the contents of the files are not identical. 

-s Reports whether the files are "same" or "different." 

-wn Changes the width of the output line to n charac- 
ters. The default width is 72 characters. 



See Also 

cmp(C), diff(C) 
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Name 

disable - Disables logins on a port. 

Sjnitax 

disable [-d] [-e] ttynn... 

Description 

You must be the super user to use the disable command. 

The disable command manipulates the /etc/inittab file and 
signals init to disallow logins on a particular port. 

Options 

-d This option "disables" the port, 
-e This option "enables" the port. 

Examples 

disable ttyOl 

Multiple terminals can be disabled or enabled using the -d 
and -e options before the appropriate port: 

disable ttyOl -e tty02 -d tty03 

Files 

/etc/inittab 

Related Commands 

login(M), enable(C), getty(M), ps(C) 
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Name 

dos - Accesses MS-DOS files. 



Syntax 

doscat [ -r ] file ... 
dostype [ -r ] file ... 

doscopy [ -c -r ] filel file2 
doscp [ -c -r ] filel file2 

doscopy [ -r 1 file ... directory 
doscp [ -r ] file ... directory 

dosdir directory ... 

dosls directory ... 

dosmkdir directory ... 

dosrm file ... 
dosdel file ... 

dosrmdir directory ... 



Description 

The dos commands provide access to the files and director- 
ies on MS-DOS disks. The commands perform the following 
actions: 

doscat Copies one or more MS-DOS files to the standard 
dostype output. If -r is given, the files are copied 

without newline conversions (see the next sec- 
tion, "Conversions.") 

doscopy Copies files between an MS-DOS disk and a 
doscp UNIX file system. If filel and file2 are given, 
filel is copied to file2. If directory is given, 
one or more files are copied to that directory. 
If -c is given, DOS upper-case names are con- 
verted to lower-case (for UNIX compatibility). 
If -r is given, the files are copied without 
newline conversions (see the section titled 
"Conversions"). 
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Lists MS-DOS files in the standard MS-DOS 
style directory format. 

Lists MS-DOS directories and files. 

Removes files from an MS-DOS disk. 



Creates a directory on an MS-DOS disk. 

Deletes directories from an MS-DOS disk. 

The file and directory arguments for MS-DOS files and di- 
rectories have the form: 

device:name 

where device is a UNIX pathname for the special device 
file containing the MS-DOS disk, and name is a pathname 
to a file or directory on the MS-DOS disk. The two com- 
ponents are separated by a colon (:). For example, the 
argument: 

/dev/fdO:/src/file.asm 

specifies the MS-DOS file file, asm in the directory /src 
in the device file /dev/fdO. Note that slashes, not back- 
slashes, are used as filename separators for MS-DOS path- 
names. Arguments without a device name are assumed to 
be UNIX files. 

The dos commands operate on the following kinds of floppy 
disks: 

5-1/4 inch MS-DOS 
8 or 9 sectors per track 
40 tracks per side 
1 or 2 sides 

MS-DOS version 1, 2, or 3 
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dosdir 

dosls 

dosrm 
dosdel 

dosmkdir 

dosrmdlr 
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Conversions 

All MS-DOS text files use a carriage return-linefeed com- 
bination, CR-LF, to indicate a newline. UNIX uses a 
single newline LF characters. When the doscat and doscopy 
commands transfer MS-DOS text files to UNIX, they auto- 
matically remove the CR. 

When text files are transferred to MS-DOS, the commands 
insert the CR before each LF character. You can use the 
-r option to override the automatic conversion and force 
the command to perform a true byte copy, regardless of 
file type. 



Examples 

The following are examples of each type of dos command. 

To display a file contained on an MS-DOS floppy disk type: 

doscat /dev/fdO:/docs/memo.txt 

To list the contents of an MS-DOS floppy disk, type one of 
the following: 

dosdir /dev/fdO: 

dosls /dev/fdO: 

For a Series 500 with Altos System V and MS-DOS parti- 
tions, if you are in the active Altos System V partition 
and want to list files in the DOS partition, enter: 

dosls /dev/hdOl 

where /dev/hdOl is the DOS partition on the hard disk. 

On a Series 500, to copy an MS-DOS file from the MS-DOS 
partition to the current directory in the active Altos 
System V partition, enter: 

doscp /dev/M01:filename . 
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Or, to copy a file named "notes" from the Altos System V 
active partition to an existing MS-DOS directory, named 
"misc," enter: 

dosep notes /dev/hd01:/misc/notes 

The next command copies a file from an MS-DOS floppy disk 
to the current directory: 

doscopy /dev/fdO: filename . 

or, for all the files in the root directory of the 
MS-DOS floppy disk: 

doscopy /dev/fdO:"*.*" . 

To copy from a UNIX hard disk to an MS-DOS floppy disk, 
type: 

doscopy filename /dev/fdO: 

The next conmiand makes the directory /usr/docs on an 
MS-DOS disk: 

dosmkdir /dev/fdO:/usr/docs 

The following command removes the file memo, text from an 
MS-DOS disk: 

dosrm /dev/fdO: /docs/memo, txt 

To remove the directory /usr/docs from an MS-DOS disk, 
type: 

dosrmdir /dev/fdO:/usr/docs 

See Also 

dtype(C) 



Files 

/dev/fd* Floppy disk devices 
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Notes 

You cannot access MS-DOS directories with wild card speci- 
fications. You must make sure you have exclusive access 
to the device containing the MS-DOS disk. If more than 
one process tries to access the MS-DOS disk at the same 
time, the result is unpredictable. 

The diskette should be formatted using the format command 
on an MS-DOS system. 
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Name 



drive - Reads drive information written during manufactur- 
ing. 



Syntax 



drive drive-info option... 



Description 



Drive is used by the system during installation. The 
drive conmiand reads the hard disk drive information speci- 
fied by the option from the manufacturing drive informa- 
tion table {drive-info) and writes it on the standard out- 
put. Options include: 



cylinders Number of cylinders on the disk (ST-506 

and ESDI drives only). 

heads Number of heads on the disk (ST-506 and 

ESDI drives only). 

spt Number of sectors per track on the disk 

(ST-506 and ESDI drives only). 

secsize Number of bytes per sector on the disk 

(0=512, 1=1024) 

skew Offset between logical sector number zero 

on one track and logical sector number zero 
on the next track (default 1). 

interleave Number of sectors between consecutively 

numbered logical sectors on a track. This 
number is always 0. 

magic A number indicating that the drive informa- 

tion exists. If the number is 0xd6dl, the 
drive information exists; otherwise, it 
does not. 



megabytes Approximate number of megabytes of storage 

on the disk. 
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type If a 0 is returned, the drive is an ST-506 

drive. If a 1 is returned, the drive is an 
ESDI drive. If a 2 is returned, the drive 
is an SCSI drive. 

nblocks Number of 512-byte blocks on the disk. 

Drive information is recorded on the disk by the company 
when the computer is manufactured. The following struc- 
ture shows the format of this information: 



# pragma pack (2) 
struct drive { 

char dc_ j ump [ 3 ] ; 

char dc_unused[9] ; 

unsigned short dc_magic; 

union { 

struct { 

short dc_CYls; 
char dc_heads; 
char dc_spt; 

} dc_hsc ; 

unsigned long dc_nblocks; 
} dc_un; 

char dc_secsize; 
char dc_skew; 
char dc_interleave 
char dc_manutype; 



/* 3 bytes for a jump instruction */ 
/* unused */ 

/* magic number (Oxd6dl0 */ 



/* number of cylinders */ 

/* number of heads */ 

/* number of sectors per track */ 

/* number of sectors for SCSI */ 

/* number of bytes per sector */ 

/* skew */ 

/* interleave */ 

/* code for disk drive manufacturer * 



unsigned short dc_megabytes; 
unsigned short dc_precmp; 
char dc_drivetype ; 

}; 

#pragma packO 



/* approx. number of megabytes */ 



Example 



The following command displays the number of cylinders on 
/dev/hdO: 

drive /dev/hdO.drinfo cylinders 



Related Commands 

layout(C), sizefs(C) 
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Name 

dtype - Determines disk type. 



Sjnitax 

dtype [ -s ] device ... 



Description 

Dtype determines type of disk, prints pertinent informa- 
tion on the standard output unless the silent (-s) option 
is selected, and exits with a corresponding code (see 
below). When more than one argument is given, the exit 
code corresponds to the last argument. 



Disk 


Exit 


Message 


Type 


Code 


(optional) 


Misc. 


60 


error (specified) 




61 


empty or unrecognized data 


Storage 


70 


dump format, volume n 




71 


tar format[, extent e of n] 




72 


cpio format 




73 


cpio character (-c) format 


MS-DOS 


80 


MS-DOS 1.x, 8 sec/track, single sided 




81 


MS-DOS 1.x, 8 sec/track, dual sided 




90 


MS-DOS 8 sec/track, single sided 




91 


MS-DOS 8 sec/track, dual- sided 




92 


MS-DOS 9 sec/track, single sided 




93 


MS-DOS 9 sec/track, dual sided 




94 


MS-DOS fixed disk 




110 


MS-DOS 9 or 15 sec/track, dual sided 


UNIX 


120 


UNIX 2.x filesystem (needs fsck) 




130 


UNIX 3.x filesystem (needs fsck) 




131 


UNIX 5.x filesystem (or UNIX 3.0 



with 1024-byte blocks ~ needs fsck) 
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Notes 



UNIX file systems and dump and cpio binary formats may 
not be recognized if created on a foreign system. This is 
due to such system differences as byte and word swapping 
and structure alignment. 
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Name 

du - Summarizes disk usage. 



Syntax 

du [ -sar ] [ name ... ] 



Description 

Du reports the number of blocks contained in all files and 
directories (recursively) within each directory and file 
specified by the name argument. The block count includes 
the indirect blocks of the file. If name is missing, the 
current directory is used. 

The optional arguments are as follows: 

-s Causes the grand total only (for each of the speci- 
fied names) to be given. 

-a Causes an output line to be generated for each file. 

If neither -s or -a is specified, an output line is gener- 
ated for each directory only. 

-r Causes du to generate messages about directories that 
cannot be read, files that cannot be opened, etc., 
rather than being silent (the default). 

A file with two or more links is only counted once. 



Notes 

If the -a option is not used, non-directories given as 
arguments are not listed. 

If there are links between files in different directories 
where the directories are on separate branches of the file 
system hierarchy, du will count the excess files more than 
once. 

Files with holes in them will get an incorrect block 
count. 
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Name 

dump.hd - Dumps a hard disk to tape. 



Syntax 

/etc/dump, hd 



Description 

The dump.hd command dumps the entire file system from the 
hard disk to a cartridge tape. Go to single-user mode 
(enter /etc/singleuser) to guarantee that the hard disk is 
not being used by any other users while dump.hd is run- 
ning. 

Dump.hd only dumps the file system from the first hard 
disk to tape; it does not dump the second hard disk. If 
you want to dump the second (third) hard disk to tape, use 
the archive(C) command. 



Related Commands 

restore.hd(C), archive(C), recover(C) 



See Also 

Operations Guide 
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ECHO(C) 
Name 

echo - Echoes arguments. 

Syntax 

/bin/echo [ arg ... ] 



ECHO(C) 



Description 

Echo writes its arguments separated by blanks and termi- 
nated by a new-line on the standard output. The arguments 
are: 

-e Prints arguments on the standard output. 

-n Prints line without a new line. 

-u Uses unbuffered I/O when printing. 

Prints the arguments exactly so that an argument be- 
ginning with a dash (e.g., -e or -n) can be speci- 
fied. 

Echo also understands C-like escape conventions; beware of 
conflicts with the shell's use of \: 

\b backspace 

\c print line without new-line 

\f form-feed 

\n new-line 

\r carriage return 

\t tab 

\v vertical tab 

\\ backslash 

\0n the 8-bit character whose ASCII code is the 1-, 
2- or 3-digit octal number n. 

Echo is useful for producing diagnostics in command files 
and for sending known data into a pipe. 
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See Also 

sh(C) 



Notes 

When representing an 8-bit character by using the escape 
convention \0n, the n must always be preceded by the digit 
zero (0). 

For example, typing: echo 'WARNING:\07' will print the 
phrase WARNING: and sound the "bell" on your terminal. 
The use of single (or double) quotes (or two backslashes) 
is required to protect the "\" that precedes the "07". 
For the octal equivalents of each character, see ascii(M). 
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Name 

ed, red - Invokes a line editor. 



Syntax 

ed [-s] [-p string ] [file] 
red [-s] [-p string ] [file] 



Description 

Ed is the standard line editor. For a full-screen editor, 
see vi(C). If the file argument is given, ed simulates an 
e command (see below) on the named file; that is to say, 
the file is read into ed's buffer so that it can be ed- 
ited. 

-s Suppresses the printing of character counts by e, r, 
and w commands, of diagnostics from e and q com- 
mands, and of the ! prompt after a Ishell command. 
Also, see the "Notes" section at the end of this 
manual page. 

-p Allows the user to specify a prompt string to replace 
the default (*). 

Ed operates on a copy of the file it is editing; changes 
made to the copy have no effect on the file until a w 
(write) command is given. The copy of the text being ed- 
ited resides in a temporary file called the buffer. There 
is only one buffer. 

Red is a restricted version of ed. It will only allow 
editing of files in the current directory. It prohibits 
executing shell commands via Ishell command. Attempts to 
bypass these restrictions result in an error message. 

Both ed and red support the fspec(F) formatting capabil- 
ity. After including a format specification as the first 
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line of file and invoking ed with your terminal in stty 
-tabs or stty tab3 mode (see stty(C)), the specified tab 
stops will automatically be used when scanning file. For 
example, if the first line of a file contained: 

<:t5,10,15 s72:> 

tab stops would be set at columns 5, 10, and 15, and a 
maximum line length of 72 would be imposed. 



NOTE 

While inputing text, tab characters when typed 
are expanded to every eighth column as is the 
default. 



Commands to ed have a simple and regular structure: zero, 
one, or two addresses followed by a single-character 
commands possibly followed by parameters to that command. 
These addresses specify one or more lines in the buffer. 
Every command that requires addresses has default ad- 
dresses, so that the addresses can very often be omitted. 

In general, only one command may appear on a line. Cer- 
tain conmiands allow the input of text. This text is 
placed in the appropriate place in the buffer. While ed 
is accepting text, it is said to be in input mode. In 
this mode, no commands are recognized; all input is merely 
collected. Input mode is left by typing a period (.) 
alone at the beginning of a line, followed immediately by 
a carriage return. 

Ed supports a limited form of regular expression notation; 
regular expressions are used in addresses to specify lines 
and in some commands (e.g., s) to specify portions of a 
line that are to be substituted. A regular expression 
(RE) specifies a set of character strings. A member of 
this set of strings is said to be matched by the RE. The 
REs allowed by ed are constructed as follows: 
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The following one-character REs match a single character: 

1.1 An ordinary character {not one of those discussed 

in 1.2 below) is a one-character RE that matches it- 
self. 

1.2 A backslash (\) followed by any special character is 

a one-character RE that matches the special character 
itself. The special characters are: 

a. .,*,[, and \ (period, asterisk, left square 
bracket, and backslash, respectively), which are 
always special, except when they appear within 
square brackets ([]) (see 1.4 below). 

b. " (caret or circumflex), which is special at the 
beginning of an entire RE, or when it immediate- 
ly follows the left of a pair of square brackets 
([]) (see 1.4 below). 

c. $ (dollar sign), which is special at the end of 
an entire RE (see 3.2 below). 

d. The character used to bound (i.e., delimit) an 
entire RE, which is special for that RE (for 
example, see how slash (/) is used in the g com- 
mand, below.) 

1.3 A period (.) is a one-character RE that matches any 
character except new-line. 

1.4 A non-empty string of characters enclosed in square 
brackets ([]) is a one-character RE that matches any 
one character in that string. If, however, the first 
character of the string is a circumflex the 
one-character RE matches any character except 
new-line and the remaining characters in the string. 
The * has this special meaning only if it occurs 
first in the string. The minus (-) may be used to 
indicate a range of consecutive ASCII characters; for 
example, [0-9] is equivalent to [0123456789]. The - 
loses this special meaning if it occurs first (after 

an initial if any) or last in the string. The 
right square bracket (]) does not terminate such a 
string when it is the first character within it 
(after an initial if any); e.g., []a-f] matches 
either a right square bracket (]) or one of the let- 
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ters a through f inclusive. The four characters 
listed in 1.2. a above stand for themselves within 
such a string of characters. 

The following rules may be used to construct REs from 
one-character REs: 

2.1 A one-character RE is a RE that matches whatever the 
one-character RE matches. 

2.2 A one-character RE followed by an asterisk (*) is a 
RE that matches zero or more occurrences of the 
one-character RE. If there is any choice, the long- 
est leftmost string that permits a match is chosen. 

2.3 A one-character RE followed by \{m\}, \{mA}» or 
\{7n,n\} is a RE that matches a range of occurrences 
of the one-character RE. The values of m and n must 
be non-negative integers less than 256; \{m\} matches 
exactly m occurrences; \{mA} matches at least m oc- 
currences; \{m,n\} matches any number of occurrences 
between m and n inclusive. Whenever a choice exists, 
the RE matches as many occurrences as possible. 

2.4 The concatenation of REs is a RE that matches the 
concatenation of the strings matched by each compo- 
nent of the RE. 

2.5 A RE enclosed between the character sequences \( and 
\) is a RE that matches whatever the unadorned RE 
matches. 

2.6 The expression \n matches the same string of charac- 
ters as was matched by an expression enclosed betweei 
\( and \) earlier in the same RE. Here n is a digit; 
the sub-expression specified is that beginning with 

the nth occurrence of \( counting from the left. For 
example, the expression *\(.*\)\1$ matches a line 
consisting of two repeated appearances of the same 
string. 

Finally, an entire RE may be constrained to match only an 
initial segment or final segment of a line (or both). 
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3.1 A circumflex (*) at the beginning of an entire RE 
constrains that RE to match an initial segment of a 
line. 

3.2 A dollar sign ($) at the end of an entire RE con- 
strains that RE to match a final segment of a line. 

The construction 'entire RE$ constrains the entire RE to 
match the entire line. The null RE (e.g.,//) is equiva- 
lent to the last RE encountered. See also the last para- 
graph before "Files" below. To understand addressing in 
ed it is necessary to know that at any time there is a 
current line. Generally spepeaking, the current line is 
the last line affected by a command; the exact effect on 
the current line is discussed under the description of 
each conmiand. Addresses are constructed as follows: 

1. The character . addresses the current line. 

2. The character $ addresses the last line of the buf- 
fer. 

3. A decimal number n addresses the n-th line of the 
buffer. 

4. 'x addresses the line marked with the mark name char- 
acter X, which must be a lower-case letter. Lines 

are marked with the k command described below. 

5. A RE enclosed by slashes (/) addresses the first line 
found by searching forward from the line following 
the current line toward the end of the buffer and 
stopping at the first line containing a string match- 
ing the RE. If necessary, the search wraps around to 
the beginning of the buffer and continues up to and 
including the current line, so that the entire buffer 

is searched. See also the last paragraph before 
"Files" below. 

6. A RE enclosed in question marks (?) addresses the 
first line found by searching backward from the line 
preceding the current line toward the beginning of 
the buffer and stopping at the first line containing 
a string matching the RE. If necessary, the search 
wraps around to the end of the buffer and continues 
up to and including the current line. See also the 
last paragraph before "Files" below. 
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7. An address followed by a plus sign (+) or a minus 
sign (-) followed by a decimal number specifies that 
address plus (respectively minus) the indicated num- 
ber of lines. The plus sign may be omitted. 

8. If an address begins with + or the addition or 
subtraction is taken with respect to the current 
line; e.g, -5 is understood to mean .-5. 

9. If an address ends with + or -, then 1 is added to or 
subtracted from the address, re^ectively. As a con- 
sequence of this rule and of Rule 8, immediately 
above, the address - refers to the line preceding the 
current line. (To maintain compatibility with 
earlier versions of the editor, the character " in 
addresses is entirely equivalent to -.) Moreover, 
trailing + and - characters have a cumulative effect, 
so ~ refers to the current line less 2. 

10. For convenience, a comma (,) stands for the address 
pair 1,$, while a semicolon (;) stands for the pair 

Commands may require zero, one, or two addresses. Com- 
mands that require no addresses regard the presence of an 
address as an error. Conmiands that accept one or two ad- 
dresses assume default addresses when an insufficient num- 
ber of addresses is given; if more addresses are given 
than such a conmiand requires, the last one(s) given are 
used. 

Typically, addresses are separated from each other by a 
comma (,). They may also be separated by a semicolon (;). 
In the latter case, the current line (.) is set to the 
first address, and only then is the second address calcu- 
lated. This feature can be used to determine the starting 
line for forward and backward searches (see Rules 5 and 6, 
above). The second address of any two-address sequence 
must correspond to a line that follows, in the buffer, the 
line corresponding to the first address. 

In the following list of ed commands, the default ad- 
dresses are shown in parentheses. The parentheses are not 
part of the address; they show that the given addresses 
are the default. 
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It is generally illegal for more than one command to ap- 
pear on a line. However, any command (except e, f, r, or 
w) may be suffixed by 1, n, or p in which case the current 
line is either listed, numbered or printed, respectively, 
as discussed below under the 1, n, and p commands. 

(.)a 

<text> 

The append command reads the given text and ap- 
pends it after the addressed line; . is left at 
the last inserted line, or, if there were none, 
at the addressed line. Address 0 is legal for 
this command: it causes the "appended" text to 
be placed at the beginning of the buffer. The 
maximum number of characters that may be en- 
tered from a terminal is 256 per line (including 
the new-line character). 

(.)c 

<text> 

The change command deletes the addressed lines, 
then accepts input text that replaces these 
lines; . is left at the last line input, or, if 
there were none, at the first line that was not 
deleted. 

(.,.)d The delete command deletes the addressed lines 
from the buffer. The line after the last line 
deleted becomes the current line; if the lines 
deleted were originally at the end of the buf- 
fer, the new last line becomes the current line. 

e file The edit command causes the entire contents of 
the buffer to be deleted, and then the named 
file to be read in; . is set to the last line 
of the buffer. If no file name is given, the 
currently-remembered file name, if any, is used 
(see the f command). The number of characters 
read is typed; file is remembered for possible 
use as a default file name in subsequent e, r, 
and w conmiands. If file is replaced by !, the 
rest of the line is taken to be a shell (sh(C)) 
command whose output is to be read. Such a 
shell command is not remembered as the current 
file name. See also "Diagnostics" below. 
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E file The Edit command is like e, except that the ed- 
itor does not check to see if any changes have 
been made to the buffer since the last w com- 
mand. 

f fUe If file is given, the file name command changes 
the currently remembered file name to file; 
otherwise, it prints the currently remembered 
file name. 

{I RE /command list 

In the global command, the first step is to mark 
every line that matches the given RE. Then, for 
every such line, the given command list is exe- 
cuted with . initially set to that line. A 
single conmiand or the first of a list of com- 
mands appears on the same line as the global 
command. All lines of a multi-line list except 
the last line must be ended with a \; a, i, and 
c commands and associated input are permitted. 
The . terminating input mode may be omitted if 
it would be the last line of the command list. 
An empty command list is equivalent to the p 
command. The g, G, v, and V commands are not 
permitted in the command list. See also "Notes" 
and the last paragraph before "Files" below. 

(1,$)G/RE/ 

In the interactive Global command, the first 
step is to mark every line that matches the 
given RE. Then, for every such line, that line 
is printed, . is changed to that line, and any 
one command (other than one of the a, c, i, g, 
G, V, and V commands) may be input and is exe- 
cuted. After the execution of that conmiand, th( 
next marked line is printed, and so on; a new- 
line acts as a null command; an & causes the re- 
execution of the most recent conmiand executed 
within the current invocation of G. Note that 
the commands input as part of the execution of 
the G command may address and affect any lines 
in the buffer. The G comma nd can be te rmi- 
nated by an interrupt signal ( MiVJik\WAiISni ). 

h The help command gives a short error message 

that explains the reason for the most recent ? 
diagnostic. 
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H The Help command causes ed to enter a mode in 

which error messages are printed for all subse- 
quent ? diagnostics. It will also explain the 
previous ? if there was one. The H command 
alternately turns this mode on and off; it is 
initially off. 

(.)i 

<text> 

The insert command inserts the given text before 
the addressed line; . is left at the last in- 
serted line, or, if there were none, at the ad- 
dressed line. This command differs from the a 
command only in the placement of the input text. 
Address 0 is not legal for this command. The 
maximum number of characters that may be en- 
tered from a terminal is 256 per line (including 
the new-line character). 

(.,.+l)j The join command joins contiguous lines by re- 
moving the appropriate new-line characters. If 
exactly one address is given, this command does 
nothing. 

(.)kx The mark command marks the addressed line with 
name x, which must be a lower-case letter. The 
address 'x then addresses this line; . is un- 
changed. 

(.,.)1 The list command prints the addressed lines in 

an unambiguous way: a few non-printing charac- 
ters (e.g., tab, backspace) are represented by 
visually nmemonic overstrikes. All other 
non-printing characters are printed in octal, 
and long lines are folded. An 1 command may be 
appended to any other conmaand other than e, f, 
r, or w. 

(.,.)ma The move command repositions the addressed 
line(s) after the line addressed by a. Address 
0 is legal for a and causes the addressed 
line(s) to be moved to the beginning of the 
file. It is an error if address a falls within 
the range of moved lines; . is left at the last 
line moved. 
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(.,.)n The number command prints the addressed lines, 
preceding each line by its line number and a tab 
character; . is left at the last line printed. 
The n command may be appended to any other 
command other than e, f, r, or w. 

(.,.)p The print conmiand prints the addressed lines; . 

is left at the last line printed. The p command 
may be appended to any other command other 
than e, f, r, or w. For example, dp deletes the 
current line and prints the new current line. 

P The editor will prompt with the prompt string (* 

by default) for all subsequent commands. The P 
command alternately turns this mode on and off; 
it is initially off unless a prompt string is 
specified with the -p option. 

q The quit command causes ed to exit. No auto- 

matic write of a file is done; however, see 
"Diagnostics," below. 

Q The editor exits without checking if changes 

have been made in the buffer since the last w 
command. 

($)r file The read command reads in the given file after 
the addressed line. If no file name is given, 
the currently-remembered file name, if any, is 
used (see e and f commands). The currently- 
remembered file name is not changed unless file 
is the very first file name mentioned since ed 
was invoked: Address 0 is legal for r and 
causes the file to be read at the beginning of 
the buffer. If the read is successful, the num- 
ber of characters read is typed; . is set to 
the last line read in. If file is replaced by 
!, the rest of the line is taken to be a shell 
(sh(C)) command whose output is to be read: 
For example, "$r !ls" appends a listing of the 
current directory to the end of the file being 
edited. Such a shell command is not remembered 
as the current file name. 
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{.,.)s/RE /replacement/ or 

{.,.)s/RE /replacement /g or 

{.,.)s/RE /replacement /n n = 1-512 

The substitute command searches each addressed 
line for an occurrence of the specified RE. In 
each line in which a match is found, all 
(non-overlapped) matched strings are replaced by 
the replacement if the global replacement indi- 
cator g appears after the command. If the glob- 
al indicator does not appear, only the first 
occurrence of the matched string is replaced. 
If a number n appears after the command, only 
the nth occurrence of the matched string on each 
addressed line is replaced. It is an error for 
the substitution to fail on all addressed lines. 
Any character other than space or new-line may 
be used instead of / to delimit the RE and the 
replacement; . is left at the last line on 
which a substitution occurred. See also the 
last paragraph before "Files" below. 

An ampersand (&) appearing in the replacement is 
replaced by the string matching the RE on the 
current line. The special meaning of & in this 
context may be suppressed by preceding it by \. 
As a more general feature, the characters \n, 
where n is a digit, are replaced by the text 
matched by the nth regular subexpression of the 
specified RE enclosed between \( and \). When 
nested parenthesized subexpressions are present, 
n is determined by counting occurrences of \( 
starting from the left. When the character % is 
the only character in the replacement, the re- 
placement used in the most recent substitute 
conmiand is used as the replacement in the cur- 
rent substitute command. The % loses its spe- 
cial meaning when it is in a replacement string 
of more than one character or is preceded by a 
\. 

A line may be split by substituting a new-line 
character into it. The new-line in the replace- 
ment must be escaped by preceding it with a \. 
Such substitution cannot be done as part of a g 
or V command list: 
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(.,.)ta This command acts just like the m command, ex- 
cept that a copy of the addressed lines is 
placed after address a (which may be 0); . is 
left at the last line of the copy. 

u The undo command nullifies the effect of the 

most recent command that modified anything in 
the buffer, namely the most recent a, c, d, g, 
i, j, m, r, s, t, V, G, or V command. 

{l,%)v/RE/ command list 

This command is the same as the global command 
g except that the command list is executed with 
. initially set to every line that does not match 
the RE. 

(1,$)V/RE/ 

This command is the same as the interactive 
global command G except that the lines that are 
marked during the first step are those that do 
not match the RE. 

(l,$)w file 

The write command writes the addressed lines 
into the named file. If the file does not ex- 
ist, it is created with mode 666 (readable and 
writable by everyone), unless your umask setting 
(see umask(C)) dictates otherwise. The 
currently-remembered file name is not changed 
unless file is the very first file name men- 
tioned since ed was invoked. If no file name is 
given, the currently-remembered file name, if 
any, is used (see e and f commands); . is un- 
changed. If the command is successful, the num- 
ber of characters written is typed. If file is 
replaced by !, the rest of the line is taken to 
be a shell (sh(C)) command whose standard input 
is the addressed lines. Such a shell conmaand is 
not remembered as the current file name. 

X An encrjTption key is requested from the standarc 

input. Subsequent e, r, and w commands will us^ 
this key to encrypt or decrypt the text. An 
explicitly empty key turns off encryption. 
Also, see the -x option of ed. 
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($)= The line number of the addressed line is typed; 

. is unchanged by this command. 

Ishell command 

The remainder of the line after the ! is sent 
to the operating system shell (sh(C)) to be in- 
terpreted as a command. Within the text of that 
command, the unescaped character % is replaced 
with the remembered file name; if a ! appears 
as the first character of the shell command, it 
is replaced with the text of the previous shell 
command. Thus, !! will repeat the last shell 
command: If any expansion is performed, the ex- 
panded line is echoed; . is unchanged. 

(.+l)<new-line> 

An address alone on a line causes the addressed 
line to be printed. A new-line alone is equiva- 
lent to .+lp; it is useful for stepping forward 
through the buffer. 

If an interrupt signal l MiY/^M9ATE[M ) is sent, ed prints a ? 
and returns to its command level. 

Some size limitations: 512 characters per line, 256 char- 
acters per global command list, and 64 characters per file 
name, the limit on the number of lines depends on the 
amount of user memory. 

When reading a file, ed discards ASCII NUL characters. 
Files (e.g., a.out) that contain characters not in the 
ASCII set (bit 8 on) cannot be edited by ed. 

If a file is not terminated by a new-line character, ed 
adds one and outputs a message explaining what it did. 

If the closing delimiter of a RE or of a replacement 
string (e.g.,/) would be the last character before a 
new-line, that delimiter may be omitted, in which case the 
addressed line is printed. The following pairs of com- 
mands are equivalent: 

s/sl/s2 s/sl/s2/p 
g/sl g/sl/p 
?sl ?sl? 
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Files 



/usr/tmp 



default directory for temporary work file 



$TMPDIR 



if this environmental variable is not null, 
its value is used in place of /usr/tmp as 
the directory name for the temporary work 
file 



ed.hup 



work is saved here if the terminal is hung 
up 



Diagnostics 
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For command errors. 



?file 



For an inaccessible file, (use the help and 
Help conmiands for detailed explanations). 



If changes have been made in the buffer since the last w 
command that wrote the entire buffer, ed warns the user if 
an attempt is made to destroy ed's buffer via the e or q 
commands. It prints ? and allows one to continue edit- 
ing. A second e or q command at this point will take ef- 
fect. The -s command-line option inhibits this feature. 



edit(C), ex(C), grep(C), sed(C), sh(C), stty(C), umask(C), 
vi(C) fspec(F), regexp(S) in the Reference (CP, S, F) 



A I command cannot be subject to a g or a v command. 
The ! command and the ! escape from the e, r, and w com- 
mands cannot be used if the editor is invoked from a re- 
stricted shell (see sh(C)). The sequence \n in a RE does 
not match a new-line character. Characters are masked to 
7 bits on input. If the editor input is coming from a 
command file (e.g., ed file < ed-cmd-file), the editor 
will exit at the first failure. 



See Also 



Notes 
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The - option, although supported in this release for up- 
ward compatibility, will no longer be supported in the 
next major release of the system. Convert shell scripts 
that use the - option to use the -s option, instead. 
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Name 

edit - Text editor (variant of ex for casual users). 



Syntax 

edit [ -r ] name... 



Description 

Edit is a variant of the text editor ex recommended for 
new or casual users who wish to use a command-oriented 
editor. 

-r Recover file after an editor or system crash. 

This brief introduction should help you get started with 
edit. To edit the contents of an existing file, enter 
edit filename. Edit makes a copy of the file which you 
can then edit, and tells you how many lines and characters 
are in the file. To create a new file, just make up a 
name for the file and try to run edit on it. 

Edit prompts for commands with a colon (:), which you 
should see after starting the editor. If you are editing 
an existing file, then you will have some lines in edit's 
buffer (its name for the copy of the file you are 
editing). Most commands to edit use its "current line" if 
you do not tell them which line to use. Thu s, if yo u say 
print (which can be abbreviated p) and press B'lAilW (as you 
should after all edit commands), this current line will be 
printed. If you delete (d) the current line, edit will 
print the new current line. When you start editing, edit 
makes the last line of the file the current line. If you 
delete this last line, then the new last line becomes the 
current one. In general, after a delete, the next line in 
the file becomes the current line. (Deleting the last 
line is a special case.) 

If you start with an empty file or wish to add some new 
lines, then the append (a) command can be used. After you 
give this command (typing a carriage return after the word 
append), edit will read lines from your terminal until you 
give a line consisting of just a period (.), placing these 
lines after the current line. The last line you type then 
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becomes the current line. The command insert (i) is like 
append but places the lines you give before, rather than 
after, the current line. 

Edit numbers the lines in the buffer, with the first line 
having number 1. If you give the conunand 1 then edit will 
type this first line. If you then give the command de- 
lete, edit will delete the first line, line 2 will become 
line 1, and edit will print the current line (the new line 
1) so you can see where you are. In general, the current 
line will always be the last line affected by a command. 

You can make a change to some text within the current line 
by using the substitute (s) command. You type s/old/new/ 
where old is replaced by the old characters you want to 
get rid of and new is the new characters you want to re- 
place it with. 

The command file (f) will tell you how many lines there 
are in the buffer you are editing and will say 
"[Modified]" if you have changed it. After modifying a 
file, you can put the buffer text back to replace the file 
by giving a write (w) command. You can then leave the 
editor by issuing a quit (q) command. If you run edit on 
a file, but do not change it, it is not necessary (but 
does no harm) to write the file back. If you try to quit 
from edit after modifying the buffer without writing it 
out, you will be warned that there has been "No write 
since last change" and edit will wait for another command. 
If you don't want to write the buffer out, then you can 
issue another quit command. The buffer is then ir- 
retrievably discarded, and you return to the shell. 

By using the delete and append commands, and giving line 
numbers to see lines in the file, you can make any changes 
you desire. You should learn at least a few more things, 
however, if you are to use edit more than a few times. 

The change (c) command will change the current line to a 
sequence of lines you supply (as in append) you give 'lines 
up to a line consisting of only a period (.). You can 
tell change to change more than one line by giving the 
line numbers of the lines you want to change, i.e., 
3,5change. You can print lines this way too. Thus l,23p 
prints the first 23 lines of the file. 



2 



EDIT(C) 



EDIT(C) 



The undo (u) command will reverse the effect of the last 
command you gave which changed the buffer. Thus if you 
give a substitute command taht does not do what you want, 
you can use the undo command to restore the old contents 
of the line. You can also undo an undo command. 

Edit will give you a warning message when commands you 
do affect more than one line of the buffer. If the amount 
of change seems unreasonable, you should consider doing an 
undo and looking to see what happened. If you decide that 
the change is ok, then you can press u again to get it 
back. Note that commands such as write and quit cannot 
be undone. 

To look at the next line in the buff er, just press Bg/J8W . 
To loo k at a number of lines, press Mtakmm (press the 
key and, wh ile it is held down, press the d key) 
rather than Brfdil'W . This will show you a half screen of 
lines on a CRT or 12 lines on a hardcopy terminal. You 
can look at the text around you by giving the command, z. 
The current line will then be the last line printed; you 
can get back to the line where you were before the z com- 
mand by t57ping a double quote ("). 

The z command can also be given other characters: z+ 
prints a screen of text (or 24 lines) ending where you 
are; z+ prints the next screenful. If you want less than 
a screenful of lines, type in z.l2 to get 12 lines total. 
This method of giving counts works in general; thus you 
can delete 5 lines starting with the current line with the 
command delete 5. 

To find things in the file, you can use line numbers if 
you happen to know them; since the line numbers change 
when you insert and delete lines this is somewhat unreli- 
able. You can search backwards and forwards in the file 
for strings by giving commands of the form /text/ to 
search forward for text, or 7text7 to search backward for 
text. If a search reaches the end of the file without 
finding the text, it goes back to the beginning, and con- 
tinues to search back to the line where you are. A useful 
feature here is a search of the form /"text/ which 
searches for text at the beginning of a line. Similarly, 
/text$/ searches for text at the end of a line. You can 
leave off the trailing / or ? in these commands. 
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The current line has a symbolic name dot (.); this is most 
useful in a range of lines as in .,$print which prints the 
rest of the lines in the file. To get to the last line in 
the file, you can refer to it by its symbolic name "$". 
Thus the command $ delete or $d deletes the last line in 
the file, no matter which line was the current line be- 
fore. Arithmetic with line references is also possible. 
Thus the line "$-5" is the fifth before the last, and 
".+20" is 20 lines after the present. 

You can find out the current line by typing .=. This is 
useful if you wish to move or copy a section of text with- 
in a file or between files. Find out the first and last 
line numbers you wish to copy or move (say 10 to 20). For 
a move, you can then enter 10,20delete a, which deletes 
these lines from the file and places them in a buffer 
named a. Edit has 26 such buffers named a through z. You 
can later get these lines back by doing "put a" to put the 
contents of buffer a after the current line. If you want 
to move or copy these lines between files, you can give an 
edit (e) command after copying the lines, following it 
with the name of the other file you wish to edit, i.e., 
"edit chapter2". By changing delete to yank above, you 
can get a pattern for copying lines. If the text you wish 
to move or copy is all within one file, then you can just 
type 10,20move $, for example. It is not necessary to use 
named buffers in this case (but you can if you wish). 



See Also 

id(C), ex(C), vi(C) 
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Name 

egrep - Searches a file for a pattern using full regular 
expressions. 



Ssmtax 

egrep [options] full regular expression [file ...] 



Description 

Egrep {expression grep) searches files for a pattern of 
characters and prints all lines that contain that pattern. 
Egrep uses full regular expressions (expressions that have 
string values that use the full set of alphanumeric and 
special characters) to match the patterns. It uses a fast 
deterministic algorithm that sometimes needs exponential 
space. 

Egrep accepts full regular expressions as in ed{C), except 
for \( and \), with the addition of: 

1. A full regular expression followed by + that matches 
one or more occurrences of the full regular expres- 
sion. 

2. A full regular expression followed by ? that matches 
0 or 1 occurrences of the full regular expression. 

3. Full regular expressions separated by | or by a 
new-line that match strings that are matched by any 
of the expressions. 

4. A full regular expression that may be enclosed in 
parentheses () for grouping. 

Be careful using the characters $, *, [, ], (,), and \ 
in full regular expression^ because they are also meaning- 
ful to the shell. It is safest to enclose the entire full 
regular expression in single quotes 

The order of precedence of operators is [], then *?+, then 
concatenation, then | and new-line. 
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If no files are specified, egrep assumes standard input. 
Normally, each line found is copied to the standard out- 
put. The file name is printed before each line found if 
there is more than one input file. 

Conmiand line options are: 

-b Precede each line by the block number on which it was 
found. This can be useful in locating block numbers 
by context (first block is 0). 

-c Print only a count of the lines that contain the pat- 
tern. 

-h Suppress the filename header at the beginning of each 
line. 

-i Ignore upper/lower case distinction during compari- 
sons. 

-1 Print the names of files with matching lines once, 

separated by newlines. Does not repeat the names of 
files when the pattern is found more than once. 

-n Precede each line by its line number in the file 
(first line is 1). 

-s Suppress the error message for an inaccessible file. 

-V Print all lines except those that contain the pat- 
tern. 

-e special expression 

Search for a special expression {full regular expres- 
sion that begins with a -). 

-f file 

Take the list of full regular expressions from file. 



See Also 

ed(C), fgrep(C), grep(C), sed(C), sh(C) 
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Diagnostics 

Exit status is 0 if any matches are found, 1 if none, 2 
for sjmtax errors or inaccessible files (even if matches 
were found). 



Notes 

Ideally there should be only one grep conmiand, but there 
is not a single algorithm that spans a wide enough range 
of space-time tradeoffs. Lines are limited to BUFSIZ 
characters; longer lines are truncated. BUFSIZ is de- 
fined in /usr/include/stdio.h. 
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Name 

enable - Enables logins on a port. 

Syntax 

enable [-d] [-e] ttynn... 

Description 

The enable command manipulates the /etc/inittab file and 
signals init(M) to allow logins on a particular port. 
(However, never enable a printer port.) You must be the 
super-user to use this command. 

Options 

-d,-e The -d and -e options can be used in a single 

command line to enable (-e) login on some ports 
and disallow (-d) logins on others. 

Examples 

In the example below, ttyOl is enabled: 
enable ttyOl 

In the next example, the -d and -e options are put in be- 
fore the appropriate port names to allow and disallow 
logins on those ports. 

enable console -e tty02 -d tty03 tty04 

Related Commands 

login(M), disable(C), inittab(M) 

Files 

/etc/inittab 
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Name 



enroll, xsend, xget - Secret mail. 



Syntax 



enroll 

xsend person 
xget 



Description 

These commands implement a secure communication channel; 
like mail(C), but no one can read the messages except the 
intended recipient. The method embodies a public-key 
cryptosystem using knapsacks. 

To receive messages, use enroU; it asks you for a pass- 
word that you must subsequently quote in order to receive 
secret mail. 

To receive secret mail, use xget. It asks for your pass- 
word, then gives you the messages. Typing a ? displays a 
menu of valid xget commands. 

To send secret mail, use xsend in the same manner as the 
ordinary mail command. (However, it will accept only one 
target.) A message announcing the receipt of secret mail 
is also sent by ordinary mail. 



Files 



/usr/spool/secretmail/*.key 
/usr/spool/secretmail/*. [0-9] 



Public keys 
Messages 



See Also 



mail(C) 
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Name 

env - Sets environment for command execution. 



Syntax 

env [-] [ name=value ... ] [ command orgs ] 



Description 

Env obtains the current environment, modifies it according 
to its arguments, then executes the command with the modi- 
fied environment. Arguments of the form name=value are 
merged into the inherited environment before the command 
is executed. The - flag causes the inherited environment 
to be ignored completely, so that the command is executed 
with exactly the environment specified by the arguments. 
If no conmiand is specified, the resulting environment is 
printed, one name/value pair per line. 



See Also 

sh(C), environ(M), profile(M), and exec(S) in the 
Reference (CP, S, F) 
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Name 

errstop - Terminates the error-logging daemon. 

Syntax 

/etc/errstop 

Description 

The error-logging daemon strerr(M) is terminated by using 
errstop. This is accomplished by executing ps(C) to de- 
termine the daemon's identity and then sending it a soft- 
ware kill signal. Only the super-user may use errstop. 

See Also 

ps(C), kilKC), strerr(M) and signal(S) in the Reference 
(CP, S, F) 
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Name 

ex - Invokes a text editor. 



Syntax 

ex [ - ] [ -V ] [ -t fag ] [ -r file ] [ -L ] [ -R ] 
[ -c command ] file ... 



Description 

Ex is the root of a family of editors: ex and vi. Ex is 
a superset of ed(C), with the most notable extension being 
a display editing facility. Display-based editing is the 
focus of vi(C). 



For ed Users 

If you have used ed you will find that ex has a number of 
new features useful on CRT terminals. Intelligent termi- 
nals and high speed terminals are very pleasant to use 
with vi. Generally, the editor uses far more of the capa- 
bilities of terminals than ed does, and uses the terminal 
capability data base and the type of the terminal you are 
using from the variable TERM in the environment to deter- 
mine how to drive your terminal efficiently. The editor 
uses features such as insert and delete character and line 
in its visual conmiand (abbreviated vi); this is the cen- 
tral mode of editing when using vi. 

Ex contains a number of new features for easily viewing 
the text of the file. The z comman d gives easy access to 
windows of text. Pressing TOiBM causes the editor to 
scroll a half-window of text and is more use ful for quick- 
ly stepping through a file than just pressing BtfJIiB . Of 
course, the screen-oriented visual mode gives constant 
access to editing context. 

Ex gives you more help when you make mistakes. The undo 
(u) command lets you reverse any single change that goes 
astray. Ex gives you a lot of feedback, normally printing 
changed lines, and indicates when more than a few lines 
are affected by a command. So it is easy to detect when 
a command has affected more lines than it should have. 
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The editor also normally prevents overwriting existing 
files unless you edited them so that you do not acciden- 
tally clobber with a write a file other than the one you 
are editing. If the system (or editor) crashes, you can 
use the editor recover command to retrieve your work. 
This will get you back to within a few lines of where you 
left off. 

Ex has several features for dealing with more than one 
file at a time. You can give it a list of files on the 
command line and use the next (n) command to deal with 
each in turn. The next command can also be given a list 
of file names, or a pattern as used by the shell to speci- 
fy a new set of files to be dealt with. In general, file 
names in the editor may be formed with full shell meta- 
ssmtax. The metacharacter is also available in form- 
ing file names and is replaced by the name of the current 
file. 

For moving text between files and within a file the editor 
has a group of buffers, named a through z. You can place 
text in these named buffers and carry it over when you 
edit another file. 

There is a command & in ex which repeats the last substi- 
tute command. In addition there is a confirmed substitute 
command. You give a range of substitutions to be done and 
the editor interactively asks whether each substitution is 
desired. 

It is possible to ignore case of letters in searches and 
substitutions. Ex also allows regular expressions which 
match words to be constructed. This is convenient, for 
example, in searching for the word "edit" if your document 
also contains the word "editor." 

Ex has a set of options which you can set to tailor it to 
your liking. One option which is very useful is the auto- 
indent option which allows the editor to automatically 
supp ly leadin g white space to align text. You can then 
use Mtunmm as a backtab and space and tab forward to alig 
new code easily. 

Miscellaneous new useful features include an intelligent 
join (j) command which supplies white space between joined 
lines automatically, conmiands < and > which shift groups 
of lines, and the ability to filter portions of the buffer 
through conmiands such as sort. 
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Invocation Options 

The following invocation options are interpreted by ex: 

Suppresses all interactive-user feedback. 
This is useful in processing editor 
scripts. 



-V 



-t tag 
-r file 



-R 



-c command 



file 



Invokes vi. 

Edits the file containing the tag and 
position the editor at its definition. 

Recovers file after an editor or system 
crash. If file is not specified a list of 
all saved files will be printed. 

Lists the names of all files saved as the 
result of an editor or system crash. 

Sets readonly mode, which prevents acciden- 
tally overwriting the file. 

Begins editing by executing the specified 
editor search or positioning command. 

Indicates files to be edited. 



Ex States 
Command 

Insert 
Visual 



Normal and initial state. Input prompted 
for by :. Your kill character cancels par- 
tial command. 

Entered by a, i, or c. Arbitrary text may 
be entered. Insert is normally terminated 
by a line having only . on it, or abnor- 
mally with an interrupt. 

Entered by vi, terminates with Q or *\. 
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Ex Command Names and Abbreviations 



abbrev 


ab 


next 


n 


unabbrev 


una 


append 


a 


number 


nu 


undo 


u 


args 


ar 






unmap 


unm 


change 


c 


preserve 


pre 


version 


ve 


CODV 


CO 


print 


n 

tr 


visual 


vi 


delete 


d 


put 


DU 


write 


w 


edit 




Quit 


a 


xit 


X 


file 


f 


read 


re 


yank 


va 


global 


g 


recover 


rec 


window 


z 


insert 


i 


rewind 


rew 


escape 


I 


join 


j 


set 


se 


Ishift 


< 


list 


1 


shell 


sh 


print next 


CR 


map 




source 


so 


resubst 


& 


mark 


ma 


stop 


St 


rshift 


> 


move 


m 


substitute 


s 


scroll 





Ex Command Addresses 



n line n /pat next with pat 

current ?paf previous with pat 

$ last x-n n before x 

+ next x,y x through y 

previous 'x marked with x 

+n n forward " previous context 

% 1,$ 

Initializing Options 

EXINIT Place sets here in environment var 

$HOME/.exrc Editor initialization file 

./.exrc Editor initialization file 

set X Enable option 

set nox Disable option 

set x=val Give value val to option x 

set Show changed options 

set all Show all options 

set X? Show value of option x 
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Most Useful Options 



autoindent 

autowrite 

ignorecase 

Ust 

magic 

modelines 



number 
paragraphs 
redraw 
report 



scroll 

sections 

shiftwidth 

showmiatch 

showmode 

slowopen 

term 



window 

wrapscan 

wrapmargin 



ai Supply indent 

aw Write before changing files 

ic In scanning 

Print "I for tab, $ at end 
.[* special in patterns 
First five lines and last five 
lines executed as vi/ex com- 
mands if they are in the form 
viicommand: or exicommand: 
nu Number lines 
para Macro names which start... 
Simulate smart terminal 
Informs you if the number of 
lines modified by the last 
command is greater than the 
value of the report variable 
command mode lines 
Command mode lines 
sect Macro names... 
sw For <>, and input 
sm To ) and } as typed 
smd Show insert mode in vi 
slow Stop updates during insert 
Specifies to vi the type of 
terminal being used (the default 
is the term value of the 
environmental variable TERM) 
Visual mode lines 
ws Around end of buffer? 
wm Automatic line splitting 



Scanning Pattern Formation 





Beginning of line 


$ 


End of line 




Any character 


\< 


Beginning of word 


\> 


End of word 


[str] 


Any char in str 


rstr] 


Not in str 


Ix-y] 


Between x and y 


* 


Any number of preceding 
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Author 

Vi and ex are based on software developed by The Univer- 
sity of California, Berkeley California, Computer Science 
Division, Department of Electrical Engineering and Com- 
puter Science. 



Files 



/usr/lib/ex. strings 
/usr/lib/ex. recover 
/usr/lib/ex.preserve 
/usr/lib/*/* 

$HOME/.exrc 

./.exrc 

/tmp/Exnnnnn 

/tmp/Rxnnnnn 

/usr/preserve/Iogm 



Error messages 
Recover command 
Preserve command 
Describes capabilities of ter- 
minals 

Editor startup file 
Editor startup file 
Editor temporary 
Named buffer temporary 
Preservation directory (where 
login is the user's login) 



See Also 



awk(C), ed(C), edit(C), grep(C), sed(C), vi(C) term(M), 
terminfo(M) and curses(S) in the Reference (CP, S, F) 



Notes 

The undo command causes all marks to be lost on lines 
changed and then restored if the marked lines were 
changed. Undo never clears the buffer modified condition. 

The z conmiand prints a number of logical rather than phy- 
sical lines. More than a screen full of output may result 
if long lines are present. 

File input/output errors do not print a name if the com- 
mand line '-' option is used. 

There is no easy way to do a single scan ignoring case. 

The editor does not warn if text is placed in named buf- 
fers and not used before exiting the editor. Null charac- 
ters are discarded in input files and cannot appear in 
resultant files. 
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Name 

expr - Evaluates arguments as an expression. 

) 

Syntax 

expr arguments 



Description 

The arguments are taken as an expression. After evalua- 
tion, the result is written on the standard output. Terms 
of the expression must be separated by blanks. Characters 
special to the shell must be escaped. Note that zero is 
returned to indicate a zero value, rather than the null 
string. Strings containing blanks or other special char- 
acters should be quoted. Integer-valued arguments may be 
preceded by a minus sign. Internally, integers are 
treated as 32-bit, 2s complement numbers. 

The operators and keywords are listed below. Characters 
that need to be escaped are preceded by \. The list is in 
order of increasing precedence, with equal precedence op- 
erators grouped within braces ({ and }). 

expr \\ expr 

Returns the first expr if it is neither null nor 0, 
otherwise returns the second expr. 

expr \& expr 

Returns the first expr if neither expr is null nor 0, 
otherwise returns 0. 

expr { =, \>, \>=, \<, \<=, != } expr 

Returns the result of an integer comparison if both 
arguments are integers, otherwise returns the result 
of a lexical comparison. 

expr { +, - } expr 

Addition or subtraction of integer-valued arguments. 
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expr { \*, /, % } expr 

Multiplication, division, or remainder of the 
integer-valued arguments. 

expr : expr 

The matching operator : compares the first argument 
with the second argument which must be a regular ex- 
pression; regular expression sjnitax is the same as 
that of ed(C), except that all patterns are 
"anchored" (i.e., begin with a caret (*)) and there- 
fore the caret is not a special character in that 
context. (Note that in the shell, the caret has the 
same meaning as the pipe ssnnbol (|).) Normally the 
matching operator returns the number of characters 
matched (zero on failure). Alternatively, the 
\(...\) pattern S5mibols can be used to return a por- 
tion of the first argument. 



Examples 

To add 1 to the shell variable a: 

a=*expr $a + P 

For $a equal to either "/usr/abc/file" or just "file," 

expr $a : •.*/\(.*\)' \| $a 

returns the last segment of the pathname (i.e., file). 
Watch out for the slash alone as an argument; expr will 
take it as the division operator (see "Notes" below). 

Even better and more simple than the above expression, add 
the // characters to eliminate any ambiguity about the 
division operator: 

expr //$a : ♦.*/\(.*\)' 

To return the number of characters in $VAR: 
expr $VAR : '.*' 
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Related Commands 
ed(C), sh(C) 

Diagnostics 

As a side effect of expression evaluation, expr returns 
the following exit values: 

0 If the expression is neither null nor zero 

1 If the expression is null or zero 

2 For invalid expressions 
Other diagnostics include: 

syntax error For operator/operand errors 

nonnumeric argument If arithmetic is attempted on 

such a string 

Notes 

After argument processing by the shell, expr cannot tell 
the difference between an operator and an operand except 
by the value. If $a is an equal sign (=), the command: 

expr $a = 

looks like: 

expr = = = 

Thus the arguments are passed to expr (and will all be 
taken as the = operator). The following permits comparing 
equal signs: 

expr X$a = X= 
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Name 

factor - Factors a number. 



Syntax 

factor [ integer ] 



Description 

When factor is invoked without an argument, it waits for a 
number to be typed. If you type in a positive number less 
than 10 , it will factor the number and print its prime 
factors; each one is printed the proper number of times. 
Then it waits for another number. Factor exits if it en- 
counters a zero or any nonnumeric character. 

If factor is invoked with an argument, it factors the num- 
ber as above and then exits. 

The time it takes to factor a number, n, is proportional 
to sqrt(n). It usually takes longer to factor a prime or 
the square of a prime, than to factor other numbers. 



Diagnostics 

Factor returns an error message if the supplied input 
value is greater than 10 or if it is not an integer num- 
ber. 
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Name 

false - Returns with a nonzero exit value. 

Syntax 

false 

Description 

The false command returns a nonzero exit value and is typ- 
ically used in shell procedures. 

Example 

Following is an example of using false in a shell proce- 
dure: 

until false 
do 

command 

done 

Related Commands 

sh(C), true(C) 

Diagnostics 

False has exit status 1. 
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Name 



fcopy - Copies a floppy diskette. 



Sjnitax 

fcopy 



Description 

Use the fcopy command to make duplicate copies of a floppy 
diskette. The routine is menu driven and will prompt you 
when to insert and remove the diskette. After one copy 
has been made, you can make additional copies of the same 
diskette. 

All new diskettes must be formatted before they can be 
copied (see format(C)). 



Example 



To copy a floppy diskette, type: 



fcopy 



and press 



The screen displays the following: 



1 - Copy low density floppy tliskette 

2 - Copy high density floppy diskette 
S - Quit 




Insert blank diskette, press RETURN 
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During this phase, the system copies the data from the 
hard disk to the blank diskette. 

Depending on the amount of data, you may be prompted to 
repeat the above procedure. 



Files 



/tmp/ junk. ?????? Temporary working file, created and 
subsequently removed by feopy. 



Related Commands 

format(C), dd(C) 
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Name 

fdisk - Maintains disk partitions (Series 500 only). 



Syntax 

fdisk [[-p] [-n] [-x] [-ad partition] [-c start size type] 
[-f devicename]] 



Description 

Fdisk displays information about disk partitions. Fdisk 
also creates and deletes disk partitions and changes the 
active partition. Fdisk functionality is a superset of 
the MS-DOS command of the same name. Fdisk is usually 
used interactively from a menu. 

The hard disk has at most four partitions. Only one par- 
tition is active at any given time. It is possible to 
assign a different operating system to each partition. 
Once a partition is made active, the operating system res- 
ident in the partition boots automatically once the cur- 
rent operating system is halted. 

To use Altos System V, at least one partition must be as- 
signed to Altos System V. 

The "Use Entire Disk for Altos System V" option always 
leaves the first track unassigned. The first track on the 
hard disk is reserved for masterboot. 

For example, if a disk has 2442 tracks, fdisk reports 
these as tracks 0-2441. Fdisk will assign (using the "Use 
Entire Disk for Altos System V" option) tracks 1-2441. 
(Track 0 is reserved for masterboot.) 

Partitions are defined by a "partition table" at the end 
of the master boot block. The partition table provides 
the location and size of the partitions on the disk. The 
partition table also defines the active partition. Each 
partition can be assigned to Altos System V, DOS or some 
other operating system. The DOS partition must be for- 
matted using the DOS format command. Once a DOS par- 
tition is set up, DOS files and directories resident in the 
DOS partition may then be accessed while running Altos 
System V by means of the dos(C) commands. 
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Arguments 

These flags are used to invoke fdisk non-interactively: 

-a number Activates the specified partition num- 

ber. 

-c start size type Creates partition with specified 

start, size, and type; start and size 
are specified in tracks, and type is 
one of: 

1 = Altos System V partition 

2 = DOS partition 

-d number Deletes the specified partition 

number. 

-f name Opens device name and reads the 

partition table associated with the 
device's partition. The default is 
/dev/rhdO. entire. 

Deletes all partitions and removes the 
masterboot. The disk must be com- 
pletely re-installed. 

Prints out the partition table. Dis- 
plays the partition number, start, 
end, size, and type; start, end, and 
size are given in tracks. 

Uses the entire disk for UNIX. 



-P 



Options 

The fdisk command displays a prompt and a menu of options. 
Updates to the disk are not made until you enter "q" from 
the main menu. 



FDISK(C) 
1. 



Display Partition Table. 



FDISK(C) 



This option displays a table of information about 
each partition on the hard disk. The PARTITION 
column gives the partition number. The STATUS 
column tells whether the partition is active (A) or 
inactive (I). TYPE tells whether the partition is 
Altos System V, DOS, or "other." the option also 
displays the starting track, ending track and total 
number of tracks in each partition. 

2. Use Entire Disk for Altos System V 

Fdisk creates one partition that includes all the 
tracks on the disk, except the first track and the 
last cylinder. This partition is assigned to Altos 
System V and is designated the active partition. 

3. Create a Partition 

The option allows the creation of a partition by al- 
tering the partition table. Fdisk reports the number 
of tracks available for each partition and the number 
of tracks in use. Fdisk prompts for the partition to 
create, the starting track, size in tracks, and par- 
tition t37pe. The change is written to the operating 
system and the hard disk when you enter "q" from the 
main menu. 

4. Activate Partition 

This option activates the spiecified partition. Only 
one partition may be active at a time. The change is 
not effective until you exit. The operating system 
residing in the newly activated partition boots once 
the current operating system is halted. 

5. Delete Partition 

This option requests which partition you wish to de- 
lete. Fdisk reports the new available amount of disk 
space in tracks. The change is not effective until 
you exit. 

Exit the fdisk program by typing a "q" at the main 
fdisk menu. Your changes are now written to the op- 
erating system and the hard disk. 
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Notes 

The minimum recommended size for an Altos System V parti- 
tion on the first hard disk is 20 megabytes. 

Since fdisk is intended for use with DOS, it may not work 
with all operating system combinations. 
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Name 

fgrep - Searches a file for a character string. 



Syntax 

fgrep [options] string [file...] 



Description 

Fgrep (fast grep) searches files for a character string 
and prints all lines that contain that string. Fgrep is 
different from grep(C) and egrep(C) because it searches 
for a string, instead of searching for a pattern that 
matches an expression. It uses a fast and compact al- 
gorithm. 

The characters $, *, [, |, {,), and \ are interpreted 
literally by fgrep; that is, ifgrep does not recognize full 
regular expressions as does egrep. Since these characters 
have special meaning to the shell, it is safest to enclose 
the entire string in single quotes 

If no files are specified, fgrep assumes standard input. 
Normally, each line found is copied to the standard out- 
put. The file name is printed before each line found if 
there is more than one input file. 

Command line options are: 

-b Precede each line by the block number on which it wa£ 
found. This can be useful in locating block numbers 
by context (first block is 0). 

-c Print only a count of the lines that contain the pat- 
tern. 

-h Suppress the filename header at the beginning of each 
line. 

-i Ignore upper/lower case distinction during compari- 
sons. 
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-1 Print the names of files with matching lines once, 

separated by newlines. Does not repeat the names of 
files when the pattern is found more than once. 

-n Precede each line by its line number in the file 
(first line is 1). 

-s Suppress the error message for an inaccessible file. 

-V Print all lines except those that contain the pat- 
tern. 

-X Print only lines matched entirely. 

-y Same as -i option. 

-e special string 

Search for a special string {string begins with a -). 

-f file 

Take the list of strings from file. 



See Also 

ed(C), egrep(C), grep(C), sed(C), sh(C) 



Diagnostics 

Exit status is 0 if any matches are found, 1 if none, 2 
for syntax errors or inaccessible files (even if matches 
were found). 



Notes 

Ideally there should be only one grep command, but there 
is not a single algorithm that spans a wide enough range 
of space-time tradeoffs. Lines are limited to BUFSIZ 
characters; longer lines are truncated. BUFSIZ is de- 
fined in /usr/include/stdio.h. 
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Name 

file - Determines file type. 



Syntax 

file [ -c ] [ -f ffile ] [ -m mfUe ] arg... 



Description 

File performs a series of tests on each argument in an 
attempt to classify it. If an argument appears to be 
ASCII, file examines the first 512 bytes and tries to 
guess its language. If an argument is an executable 
a. out, file will print the version stamp, provided it is 
greater than 0. 

-c The -c option causes file to check the magic file for 
format errors. This validation is not normally 
carried out for reasons of efficiency. No file typ- 
ing is done under -c. 

-f If the -f option is given, the next argument is taken 
to be a file containing the names of the files to be 
examined. 

-m The -m option instructs file to use an alternate 
magic file. 

File uses the file /etc/magic to identify files that have 
some sort of magic numbeTf that is, any file containing a 
numeric or string constant that indicates its type. Com- 
mentary at the beginning of /etc/magic explains its for- 
mat. 



Files 

/etc/magic 



See Also 

filehdr(F) in the Reference (CP, S, F) 
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Name 

find - Finds files that match certain conditions. 



Syntax 

find pathname-list expression 



Description 

The find program recursively searches the directory hier- 
archy for each path name in the pathname-list, looking for 
files that match a boolean expression written in the pri- 
maries given below. In the descriptions, the argument n 
is used as a decimal integer where +n means more than n, 
-n means less than n, and n means exactly n. 



Options 



-atime n True if the file has been accessed in n 

days. The access time of directories in 
pathname-list is changed by find itself. 

-epic device Always true; write the current file on 
device in cpio(C) format (5120-byte 
records). 



-etime n True if the file status (mode, ownership, 

links) has been changed in n days. 

-depth Always true; causes descent of the direc- 

tory hierarchy so that all entries in a 
directory are acted on before the directory 
itself. This can be useful when find is 
used with cpio(C) to transfer files that 
are contained in directories without write 
permission. 

-exec cmd True if the executed cmd returns a 

zero value as exit status. The end of cmd 
must be punctuated by a space and an es- 
caped semicolon. A command argument {} is 
replaced by the current pathname. 
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{expression) True if the parenthesized expression is 

true (parentheses are special to the shell 
and must be escaped). 

-group gname True if the file belongs to the group 

gnome. If gname is numeric and does not 
appear in the /etc/group file, it is taken 
as a group ID. 

-inum n True if the file has the specified inode 

number, n. 

-links n True if the file has n links. 

-local True if the file physically resides on the 

local system. 

-mount Always true; restricts the search to the 

file system containing the directory speci- 
fied, or if no directory was specified, the 
current directory. 

-mtime n True if the file data has been modified in 

n days. 

-name file True if file matches the current file name. 

Normal shell argument syntax may be used il 
escaped (watch out for the left bracket 
([), the question mark (?) and the star 
(*)). 

-newer file True if the current file has been modified 
more recently than the argument file. 

-nosym Does not descend into directories that are 

symbolic links. 

-ok cmd Like -exec except that the generated 

command line is displayed with a question 
mark first, and is and is executed only if 
the user responds by tjTping y. 
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-perm onum True if the file permission flags exactly 

match the octal number onum (see chmod(C)). 
If onum is prefixed by a minus sign, more 
flag bits (017777, see stat(S)) become sig- 
nificant and the flags are compared: 

{flags &onum)==onum 

-print Always true; causes the current pathname to 

be printed. 

-size n[c] True if the file is n blocks long (512 

bytes per block). If n is followed by a c, 
the size is in characters. 

-type c True if the type of the file is c, where c 

is b, c, d, 1, p, or f , for block special 
file, character special file, directory, 
S5nnbolic link, named pipe, or plain file. 

-user uname True if the file belongs to the user uname. 

If uname is numeric and does not appear as 
a login name in the /etc/passwd file, it is 
taken as a user ID. 

The primaries may be combined using the following opera- 
tors (in order of decreasing precedence): 

negation The negation of a primary is specified with 

the exclamation (!) unary NOT operator. 

AND The AND operation is implied by the juxta- 

position of two primaries. 

OR The OR operation is specified with the -o 

operator given between two primaries. 



Examples 

In the example below all the files named a. out or *.o that 
have not been accessed for a week are found and removed. 

find / \( -name a. out -o -name '*.o' \) \( -atime +7 \) 
-exec rm {) \; 
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See Also 

chmod(C), cpio(C), sh(C), test(C), stat(S), umask(S) 

Files 

/etc/passwd 
/etc/group 
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Name 

finger - Finds information about users. 



Syntax 

finger [ -bfilpqsw ] [ login ...] 



Description 

By default, finger lists the login name, full name, ter- 
minal name and write status (as a "*" before the terminal 
name if write permission is denied), idle time, login 
time, office location, and phone number (if known) for 
each current user. (Idle time is in minutes if it is a 
single integer, hours and minutes if a colon (:) is used, 
or days and hours if a "d" is used.) 

A longer format also exists and is used by finger whenever 
a list of names is given. (Account names as well as first 
and last names of users are accepted.) This is a 
multi-line format; including all of the information de- 
scribed above as well as the user's home directory and 
login shell, any plan which the person has placed in the 
.plan file in their home directory, and the project on 
which that user is working from the .project file, also in 
the home directory. 

Options are: 

-b Prints briefer long output format of users. 

-f Suppresses the printing of the header line (short 
format). 

-i Prints quick list of users with idle times. 

-1 Forces long output format. 

-p Suppresses printing of the .plan files. 

-q Prints quick list of users. 

-s Forces short output format. 

-w Forces narrow format list of specified users. 
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Files 



/etc/utmp 
/etc/passwd 



Who file 



User names, offices, phones, login 
directories, and shells 
Plans 
Projects 



$HOME/.plan 
$HOME/.project 



See Also 



who(C) 



Notes 



Only the first line of the .project file is printed. 

The "office" column of the output will contain any text in 
the comment field of the user's /etc/passwd file entry 
that immediately follows a comma (,). For example, if the 
entry is: 

johnd:eX8HlnAk:201:50:John Doe, 321:/usr/johnd:/bin/sh 

the number 321 will appear in the office column. 

Idle time is computed as the elapsed time since any activ- 
ity on the given terminal. This includes previous invoca- 
tions of finger which may have modified the terminal's 
corresponding device file, /dev/tty??. 

This utility was developed at the University of California 
at Berkeley and is used with permission. 
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Name 

fleece - Looks for files in home directories. 

Syntax 

fleece file 

Description 

Fleece looks for the named file in every home directory on 
the system and lists those which exist. 

Files 

/etc/passwd To find home directories 
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Name 

fmt - Simple text formatter. 



Syntax 

fmt [ file... ] 



Description 

Fmt is a simple text formatter that reads the concatena- 
tion of input files (or standard input if none are given) 
and produces on the standard output a version of its input 
with lines as close to 72 characters long as possible. 
The spacing at the beginning of the input lines is pre- 
served in the output, as are blank lines and interword 
spacing. 

Fmt is meant to format mail messages prior to sending, but 
may also be useful for other simple tasks. For instance, 
within vi(C), the command: 

!}fmt 

will reformat a paragraph, evening the lines. 



See Also 

mail(C), nroff(l) 



Notes 

The program was designed to be simple and fast; for more 
complex operations, use the standard text processors. 
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Name 

fold - Folds long lines for finite width output device. 



Syntax 

fold [ -width ] [ file ... ] 



Description 

Fold is a filter that will fold the contents of a speci- 
fied file, breaking the lines to fit a maximum width. If 
no file name is given, the program will use the standard 
input. 

Fold accepts the following option: 

-width The default for width is 80. Width should be a 
multiple of 8 if tabs are present, or the tabs 
should be expanded using expand(C) before using 
the fold command. 
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Name 

format - Formats a floppy diskette. 



Syntax 

format 



Description 

Format is a menu-driven program for formatting floppy 
disks. Disks are formatted in a 5-1/4 inch, 
double-density, double-sided format. 

For Altos systems with a dual-speed floppy drive, when you 
type format, the screen looks like this: 



1 - Altos format /dev/fd09$d$9 

2 - I0M-AT (slow) format XENIX /dfev/fd048ds9 

3 - IBM-AT (fast) format XENIX /d0v/fdO9edsl5 

4 - Quit 

Command; [default Altos] 



Type 1, then Ktf^iliB and you are prompted to insert a blank 

diskette and press ISSSI* A series of dots ( ) will 

appear on the screen. When the diskette is formatted the 
format menu reappears. Type 4 to quit; the system prompt 
returns to the screen. 



CAUTION 

The computer has a dual-speed floppy disk 
drive. Floppy disks designed for a high speed 
drive cannot be used on a low speed drive, and 
floppy disks designed for a low speed drive 
cannot be used on a high speed drive. 



The system will determine what type of floppy disk you 
have before it begins copying files to the floppy disk. 



(96 tpi 9 s0C/trk) 
(48 tpi 9 sec/tfk) 
(96 tpi 15 sec/trk) 
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Files 

/usr/lib/ffmt 

See Also 

fcopy(C), dd(C) 
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Name 

from - Who is my mail from? 

Syntax 

from 

Description 

From lists the mail header lines in your mailbox file, to 
show you who your mail is from. 

Files 

/usr /spool/mail/* 
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Name 

fsck, dfsck - Checks and repairs file systems. 



Syntax 

/etc/fsck [options] [file-system] 

/etc/dfsck [optionsl] fsysl ... - [options2] fsys2 ... 



Description of fsck 

The fsck command must be run on the root device in 
single-user mode. 

The fsck command performs a file system check by auditing 
and interactively repairing inconsistencies in the file 
system. If a file system is consistent, then the number 
of files, number of blocks used, and number of blocks free 
are reported. If the file system is inconsistent, you are 
prompted for agreement before each correction is at- 
tempted. The system waits for you to respond yes or no. 
Most corrective actions result in some loss of data. The 
amount and severity of the loss may be determined from the 
diagnostic output. If you do not have write permission, 
fsck defaults to the action of the -n option. 

Inconsistencies checked are as follows: 

• Blocks claimed by more than one inode or the free 
list 

• Blocks claimed by an inode or the free list outside 
the range of the file system 

• Incorrect link counts 

• Size checks: 

Incorrect number of blocks 
Directory size not 16-byte aligned 

• Bad inode format 

• Blocks not accounted for anywhere 

• Directory checks: 
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File pointing to unallocated inode 
Inode number out of range 

• Super-block checks; 

More than 65536 inodes 

More blocks for inodes than there are in the 
file system 

• Bad free block list format 

• Total free block or free inode count incorrect 

Orphaned files and directories (allocated but unreferenced) 
are reconnected by placing them in the lost+found direc- 
tory. The name assigned is the inode number. The only 
restriction is that the directory lost+found must pre- 
exist in the root of the file system being checked and 
must have empty slots in which entries can be made. This 
is accomplished (when the system is installed) by making 
lost+found, copying a number of files to the directory, 
and then removing them before fsck is executed. 



Options 

-b Reboot. If the file system being checked is the root 
file system and modifications have been made, then 
either remount the root file system or reboot the 
system. A remount is done only if there was minor 
damage. 

-D Checks directories for bad blocks (useful after sys- 
tem crash). 

-f Does a fast check of the ftte system (blocks and 
sizes and free list checks). Reconstructs free list 
if necessary. 

-h Complains about files whose byte and block counts 
don't match. 

-n Assumes a "no" response to all questions asked by 
fsck; does not open the file system for writing. 

-q Quiet fsck. Assumes yes in response to most ques- 
tions. Unreferenced fifos will be silently removed. 
If required, counts in the superblock will be cor- 
rected. 
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-sX Ignores the actual free list and (unconditionally) 

reconstructs a new one by rewriting the super-block 
of the file system. The file system must be un- 
mounted while this is done. If this is not possible, 
care should be taken that the system is quiescent and 
that it is rebooted immediately afterwards. This 
precaution is necessary so that the old, bad, in-core 
copy of the superblock will not continue to be used, 
or written on the file system. The -sX option allows 
for creating an optimal freelist organization. The 
format for X is cylinder sizetgap size. If X is not 
given, then the values used when the file system was 
created are used. 

-SX Conditionally reconstructs the free list. This op- 
tion is like -sX except that the free list is rebuilt 
only if there are no discrepancies discovered in the 
file system. Using -S forces a "no" response to all 
questions asked by fsck. This option is useful for 
forcing free list reorganization on uncontaminated 
file systems. 

-t If fsck cannot obtain enough memory to keep its 
tables, it uses a scratch file. If the -t option is 
specified, the file named in the next argument is 
used as the scratch file, if needed. Without -t, 
fsck prompts for the name of the scratch file. The 
file chosen should not be on the file system being 
checked, and if it is not a special file or did not 
already exist, it is removed when fsck completes. 

-y Assumes a "yes" response to all questions asked by 
fsck. 

If no file systems are specified, fsck reads a list of 
default file systems from the file /etc/checklist. 



Description of dfsck 

Dfsck allows two file system checks on two different 
drives simultaneously. Optionsl and options2 are used to 
pass options to fsck for the two sets of file systems. A 
dash (-) is the separator between the file system groups. 

Dfsck permits you to interact with two fsck programs at 
once. To aid this, dfsck will print the file system name 
for each message. 
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When answering a question from dfsck, you must prefix the 
response with a 1 or a 2 to indicate that the answer re- 
fers to the first or second file system. 

Do not use dfsck to check the root file system. 



Examples 

For example, to check the main hard disk, type: 
fsck /dev/root 

For the second hard disk, the procedure is as follows. If 
the second hard disk is mounted, type: 

/etc/umount /dev/hdlb 
fsck /dev/hdlb 

To remount the second hard disk back to usr2, type: 

/etc/mount /dev/hdlb /usr2 

If the second hard disk is not mounted, skip the umount 
and mount steps. If you have a third hard disk, substi- 
tute hd2b for hdlb and /usr3 for /usr2. 

If the file system is in good order, the screen displays: 



** Phase 1 - Check 

** Phase 2 - Check 

** Phase 3 - Check 

** Phase 4 - Check 

** Phase 5 - Check 



Blocks and Sizes 
Pathnames 
Connectivity 
Reference Count 
Free List 
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The following example shows file system inconsistencies: 



** Phase 1 - Check Blocks and Sizes 
** Phase 2 - Check Pathnames 
** Phase 3 - Check Connectivity 

Phase 4 - Check Reference Count 
tJNREF FILE I > 2124 QWNER-CHRIS MODE-100644 
S1ZK=30574 MTIME-Apr 27 07:56 1983 
CLEAR? y 

** Phase 5 Check Free l.it^t 
63 BLK(S) MISSING 
BAD FREE LIST 
SALVAGE? y 



The system automatically clears and salvages the file sys- 
tem, and the following message apppears: 



Nomal Syistem Shutdown, 



The system should automatically reboot after fsck shuts it 
down. 



Files 



/etc/checklist 



Contains default list of file systems 
to check 



See Also 

mkfs(M), ncheck(M), checklist (M), filesystem(M) 
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Notes 

Inode numbers for . and .. in each directory are not 
checked for validity. 

The fsck program will not run on a mounted non-raw file 
system unless the file system is the root file system or 
unless the -n option is specified and no writing out of 
the file system will take place. If any such attempt is 
made, a warning is displayed on the screen and no further 
processing of the file system is done for the specified 
device. 

Checking the raw device is almost always faster and should 
be used with everything but the root file system. 

Although checking a raw device is almost always faster, 
there is no way to tell if the file system is mounted. 
And cleaning a mounted file system will almost certainly 
result in an inconsistent superblock. 

Unreferenced files of size 0 are removed without asking 
first. 
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Name 

getopt - Parses command options. 
Syntax 

set — "getopt optstring $** 
Description 

Getopt is used to check and break up options in command 
lines for parsing by shell procedures. Optstring is a 
string of recognized option letters (see getopt(S)). If a 
letter is followed by a colon, the option is expected to 
have an argument which may or may not be separated from 
it by whitespace. The special option ~ is used to delimit 
the end of the options. Getopt will place ~ in the ar- 
guments at the end of the options, or recognize it if it 
is used explicitly. The shell arguments ($1 $2 ...) are 
reset so that each option is preceded by a dash (-); each 
option argument is also in its own shell argument. 

Example 

The following code fragment shows you how to process the 
arguments for a command that can take the a and b op- 
tions, and the o option, which require an argument: 

set -- 'getopt abo: $*" 

if [ $? != 0 ] 

then 

echo $USAGE 
exit 2 

fi 

for i in $* 
do 

case $i in 

-a I -b) FLAG=$i; shift;; 

-o) 0ARG=$2; shift; shift;; 

- -) shift; break;; 

esac 

done 
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This code will accept any of the following as equivalent: 

cmd -aoarg file file 
cmd -a -o arg file file 
cmd -oarg -a file file 
cmd -a -oarg - - file file 

See Also 

getopt(S), sh(C) 

Diagnostics 

Getopt prints an error message on the standard output when 
it encounters an option letter not included in optstring. 
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Name 

gets - Gets a string from the standard input. 



Syntax 

gets [ string ] 



Description 

Gets can be used with csh(C) to read a string from the 
standard input. If string is given, it is used as a de- 
fault value if an error occurs. The resulting string 
(either string or as read from the standard input) is 
written to the standard output. If no string is given and 
an error occurs, gets exits with exit status 1. 



See Also 

csh(C), line(C) 
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Name 

glossary - Defines common UNIX system terms and sjmibols. 



Syntax 

[ help ] glossary [ term ] 



Description 

The operating system Help Facility conmiand, glossary, pro- 
vides definitions of common technical terms and symbols. 

Without an argument, glossary displays a menu screen list- 
ing the terms and symbols that are currently included in 
glossary. A user may choose one of the terms or may exit 
to the shell by typing q (for "quit"). When a term is 
selected, its definition is retrieved and displayed. By 
selecting the appropriate menu choice, the list of terms 
and symbols can be redisplayed. Press KAIIW after entering 
your choice. 

A term's definition may also be requested directly from 
shell level (as shown in the sjmtax), causing a definition 
to be retrieved and the list of terms and symbols not to 
be displayed. Some of the sjmibols must be escaped if re- 
quested at shell level in order for the facility to under- 
stand the symbol. The following table lists the sjnnbols 
and their escape sequence. 



SYMBOL 


ESCAPE SEQUENCE 


mi 


\"\" 






[] 


\\[\\] 


II 


\'\' 


# 


\# 


& 


\& 


* 


\* 


\ 


WW 


1 


\| 



From any screen in the Help Facility, a user may execute a 
command via the shell (sh(C)) by tjnping a ! and the com- 
mand to be executed. The screen will be redrawn if the 
command that was executed was entered at a first level 
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prompt. If entered at any other prompt level, only the 
prompt will be redrawn. 

By default, the Help Facility scrolls the data that is 
presented to the user. If you prefer to have the screen 
clear before printing the data (non-scrolling), the shell 
variable SCROLL must be set to no and exported so it will 
become part of your environment. This is done by adding 
the following line to your .profile file (see profile(M)): 

export SCROLL ; SCROLL=no 

If you later decide that scrolling is desired, SCROLL must 
be set to yes. 

For information on each of the Help Facility commands, see 
help(C). 



See Also 

help(C), helpadm(M), locate(C), sh(C), starter(C), 
usage(C), term(M) 



Warnings 

If the shell variable TERM (see sh(C)) is not set in the 
user's .profile file, then TERM will default to the ter- 
minal value type 450 (a hard-copy terminal). For a list 
of valid terminal types, refer to tenn(M). 
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Name 

graph - Draws a graph. 



Syntax 

graph [ options ] 



Description 

Graph with no options takes pairs of numbers from the 
standard input as abscissas and ordinates of a graph. 
Successive points are connected by straight lines. The 
graph is encoded on the standard output for display. 

If the coordinates of a point are followed by a non- 
numeric string, that string is printed as a label be- 
ginning on the point. Labels may be surrounded with 
quotes ("), in which case they may be empty or contain 
blanks and numbers; labels never contain new-lines. 

The following options are recognized, each as a separate 
argument. 

-a Supply abscissas automatically (they are missing from 
the input); spacing is given by the next argument 
(default 1). A second optional argument is the 
starting point for automatic abscissas (default 0 or 
lower limit given by -x). 

-b Break (disconnect) the graph after each label in the 
input. 

-c Character string given by next argument is default 
label for each point. 

-g Next argument is grid style, 0 no grid, 1 frame with 
ticks, 2 full grid (default). 

-1 Next argument is a label for the graph. 
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-m Next argument is mode (style) of connecting lines: 0 
disconnected, 1 connected (default). Some devices 
give distinguishable line styles for other small in- 
tegers (e.g., the Tektronix 4014: 2=dotted, 
3=dash-dot, 4=short-dash, 5=long-dash). 

-s Save screen, do not erase before plotting. 

-X [ 1] 

If 1 is present, x axis is logarithmic. Next 1 (or 
2) arguments are lower (and upper) x limits. Third 
argument, if present, is grid spacing on x axis. 
Normally these quantities are determined automatic- 
ally. 

-y [ 1 ] 

Similarly for 3?. 

-h Next argument is fraction of space for height. 

-w Similarly for width. 

-r Next argument is fraction of space to move right be- 
fore plotting. 

-u Similarly to move up before plotting. 

-t Transpose horizontal and vertical axes. (Option -x 
now applies to the vertical axis.) 

A legend indicating grid range is produced with a grid 
unless the -s option is present. If a specified lower 
limit exceeds the upper limit, the axis is reversed. 



See Also 

spline(C), tplot(C) 



Notes 

The terminal- you use must have graphics capabilities for 
successful execution of this command. Graph stores all 
points internally and drops those for which there is no 
room. Segments that run out of bounds are dropped, not 
windowed. Logarithmic axes may not be reversed. 
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Name 

grep - Searches a file for a pattern. 



Syntax 

grep [options] limited regular expression [file.,.] 



Description 

Grep searches files for a pattern and prints all lines 
that contain that pattern. Grep uses limited regular ex- 
pressions (expressions that have string values that use a 
subset of the possible alphanumeric and special charac- 
ters) like those used with ed(C) to match the patterns. 
It uses a contact non-deterministic algorithm. 

Be careful using the characters $, *, [, |, (, ), and \ 
in the limited regular expression because they are also 
meaningful to the shell. It is safest to enclose the en- 
tire limited regular expression in single quotes 
If no files are specified, grep assumes standard input. 
Normally, each line found is copied to standard output. 
The file name is printed before each line found if there 
is more than one input file. 

Command line options are: 

-b Precede each line by the block number on which it wa 
found. This can be useful in locating block numbers 
by context (first block is 0). 

-c Print only a count of the lines that contain the pat- 
tern. 

-i Ignore upper/lower-case distinction during compari- 
sons. 

-1 Print the names of files with matching lines once, 

separated by newlines. Does not repeat the names of 
files when the pattern is found more than once. 

-n Precede each line by its line number in the file 
(first line is 1). 
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-s Suppress error messages about nonexistent or unread- 
able files 

-V Print all lines except those that contain the pat- 
tern. 



See Also 

ed(C), egrep(C), fgrep(C), sed(C), sh(C) 



Diagnostics 

Exit status is 0 if any matches are found, 1 if none, 2 
for syntax errors or inaccessible files (even if matches 
were found). 



Notes 

Lines are limited to BUFSIZ characters; longer lines are 
truncated. BUFSIZ is defined in /usr/include/stdio.h. 
If there is a line with embedded nulls, grep will only 
match up to the first null; if it matches, it will print 
the entire line. 
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Name 

haltsys - Closes out the file systems and halts the CPU. 



Sjnitax 

/etc/haltsys 



Description 

You must be the super-user to access this command. 

The haltsys command inmiediately terminates the operating 
system and should only be used if a sj^tem problem pre- 
vents the running of shutdown. Do not run haltsys in mul- 
tiuser mode and when other users are on the system. Since 
haltsys takes effect immediately, user processes should be 
killed beforehand (see kill(C)). 



Related Commands 

shutdown(C), kill(C), ps(C) 
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Name 

hd - Displays files in hexadecimal format. 



Syntax 

hd [ -format ] [ -s offset ] [ -n count ] [ file ... ] 



Description 

The hd command displays the contents of file in hexadeci- 
mal, octal, decimal, and character formats. Control over 
the specification of ranges of characters is also avail- 
able. The default behavior is with the following flags 
set: -abx -A. This says that addresses (file offsets) 
and bytes are printed in hexadecimal and that characters 
are also printed. If no file argument is given, the stan- 
dard input is read. 

Options include: 

-s offset Specify the beginning offset in the file where 
printing is to begin. If no file argument is 
given, or if a seek fails because the input is a 
pipe, offset bytes are read from the input and 
discarded. Otherwise, a seek error will termi- 
nate processing of the current file. 

The offset may be given in decimal, hexadecimal 
(preceded by 'Ox'), or octal (preceded by a 
'0'). It is optionally followed by one of the 
following multipliers: w, 1, b, or k; for words 
(2 bytes), long words (4 bytes), blocks (512 
bytes), or K bytes (1024 bytes). Note that this 
is one case where "b" does not stand for bytes. 
Since specifying a hexadecimal offset in blocks 
would result in an ambiguous trailing 'b', any 
offset and multiplier may be separated by an 
asterisk (*). 

-n count Specify the number of bytes to process. The 
count is in the same format as offset ^ above. 
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Format Flags 

Format flags may specify addresses, characters, bytes, 
words (2 bytes), or longs (4 bytes) to be printed in hexa- 
decimal, decimal, or octal. Two special formats may also 
be indicated: text or ASCII. Format and base specifiers 
may be freely combined and repeated as desired in order to 
specify different bases (hexadecimal, decimal or octal) 
for different output formats (addresses, characters, 
etc.). All format flags appearing in a single argument 
are applied as appropriate to all other flags in that ar- 
gument. 

acbwlA Output format specifiers for addresses, charac- 
ters, bytes, words, longs and ASCII, respective- 
ly. Only one base specifier will be used for 
addresses; the address will appear on the first 
line of output that begins each new offset in 
the input. 

The character format prints printable characters 
unchanged, special C escapes as defined in the 
language, and remaining values in the specified 
base. 

The ASCII format prints all printable characters 
unchanged, and all others as a period (.). This 
format appears to the right of the first of 
other specified output formats. A base speci- 
fier has no meaning with the ASCII format. If 
no other output format (other than addresses) is 
given, bx is assumed. If no base specifier is 
given, all of xdo are used. 

xdo Output base specifiers for hexadecimal, decimal 

and octal. If no format specifier is given, all 
of acbwl are used. 

t Print a text file, each line preceded by the 

address in the file. Normally, lines should be 
terminated by a \n character; but long lines 
will be broken up. Control characters in the 
range 0x00 to Oxlf are printed as to 
Bytes with the high bit set are preceded by a 
tilde (~) and printed as if the high bit were 
not set. The special characters ~, \) are 
preceded by a backslash (\) to escape their spe- 
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cial meaning. As special cases, two values are 
represented numerically as A177' and A377'. 
This flag will override all output format speci- 
fiers except addresses. 
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Name 

hdr - Displays selected parts of object files. 



Syntax 

hdr [ -dhlKmprsSt ] file ... 



Description 

Hdr displays object file headers, S5mibol tables, and text 
or data relocation records in human-readable formats. It 
also prints out seek positions for the various segments in 
the object file. Only a. out, x.out, and x.out segmented 
formats and archives are understood. COFF format files 
are not handled; see dump (CP). 

The sjmbol table format consists of six fields. In a. out 
formats, the third field is missing. 

1. The first field is the symbol's index or position in 
the symbol table, printed in decimal. The index of 
the first entry is zero. 

2. This field is the type, printed in hexadecimal. 

3. The third field is the s seg field, printed in hexa- 
decimal. 

4. The fourth field is the sjonbol's value in hexadeci- 
mal. 

5. This field is a single character which represents the 
symbol's type as in nm(CP), except C common is not 
recognized as a special case of undefined. 

6. The sixth field is the symbol name. 
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If long form relocation is present, the format has six 
fields. 

1. The first is the descriptor, printed in hexadecimal. 

2. The second is the symbol ID, or index, in decimal. 
This field is used for external relocations as an 
index into the symbol table. It should reference an 
undefined symbol table entry. 

3. This field is the position, or offset, within the 
current segment where relocation is to take place 
(printed in hexadecimal). 

4. The fourth field is the name of the segment refer- 
enced in the relocation: text, data, bss or EXT for 
external. 

5. The fifth field is the size of relocation: byte, 
word (2 bytes), or long. 

6. This field, if present, indicates the relocation is 
relative. 

If short form relocation is present, the format has three 
fields. 

1. The first field is the relocation command in hexa- 
decimal. 

2. This field has the referenced segment name: text or 
data. 

3. This field indicates the size of relocation: word or 
long. 

Options and their meanings are: 

-h Causes the object file header and extended header to 
be printed out. Each field in the header or extended 
header is labeled. This is the default option. 

-I Uses Intel kernel dataseg (150) and textseg (158) 
instead of the default 27 and 3F, respectively. 
(Numbers are in hex.) 
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-K Uses kernel dataseg (18) and textseg (20) instead of 
the default 27 and 3F, respectively. (Numbers are in 
hex. ) 

-d Causes the data relocation records to be printed out. 

-m Prints segment table memory images only. 

-p Causes seek positions to be printed out as defined by 
macros in the include file, a.out.h. 

-r Causes both text and data relocation to be printed. 

-s Prints the symbol table. 

-S Prints the file segment table with a header. (Only 
applicable to x.out segmented executable files.) 

-t Causes the text relocation records to be printed out. 
See Also 

a.out(F), nm(CP), dump(CP) in the Reference (CP, S, F) 
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Name 

head - Prints the first few lines of a stream. 
Syntax 

head [ -count ] [ file ... ] 
Description 

This filter prints the first count lines of each of the 
specified files. If no files are specified, head reads 
from the standard input. If no count is specified, then 
10 lines are printed. 

See Also 

tail(C) 

Notes 

This utility was developed at the University of California 
at Berkeley and is used with permission. 
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Name 

help - Operating system Help Facility. 



Syntax 
help 

[ help ] starter 

[ help ] usage [ -d ] [ -e ] [ -o ] [ command name ] 

[ help ] locate [ keywoTdl [ keywoTd2 ]... ] 

[ help ] glossary [ term ] 
help org... 



Description 

The system Help Facility provides on-line assistance for 
operating system users, whether they desire general infor- 
mation or specific assistance for use of the Source Code 
Control System (SCCS) commands. 

Without arguments, help prints a menu of available on-line 
assistance commands with a short description of their 
functions. The commands and their descriptions are: 



Command Description 



starter Information about the operating system for 

the beginning user 

locate Locate operating system commands using 

function-related keywords 

usage Operating system command usage information 

glossary Definitions of operating system technical 

terms 



The user may choose one of the above commands by enter- 
ing its corresponding letter (given in the menu), or may 
exit to the shell by ts^ing q (for "quit"). 
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With arguments, help directly invokes the named on-line 
assistance command, bypassing the initial help menu. The 
commands starter, locate, usage, and glossary, optionally 
preceded by the word help, may also be specified at shell 
level. When executing glossary from shell level some of 
the symbols listed in the glossary must be escaped 
(preceded by one or more backslash (\) characters) to be 
understood by the Help Facility. For a list of symbols 
and how many backslashes to use for each, refer to the 
glossary(C) manual page. 

From any screen in the Help Facility, a user may execute a 
command via the shell (sh(C)) by typing a I and the com- 
mand to be executed. The screen will be redrawn if the 
command that was executed was entered at a first level 
prompt. If entered at any other prompt level, only the 
prompt will be redrawn. 

By default, the Help Facility scrolls the data that is 
presented to the user. If you prefer to have the screen 
clear before printing the data (non-scrolling), the shell 
variable SCROLL must be set to no and exported so it 
will become part of your environment. This is done by 
adding the following line to your .profile file (see 
profUe(M)): 

export SCROLL ; SCROLL=no 

If you later decide that scrolling is desired, SCROLL must 
be set to yes. 

Information on each of the Help Facility commands (starter, 
locate, usage, glossary, and help) is located on their 
respective manual pages. 

If the first argument to help is different from starter, 
usage, locate, or glossary, help assumes information is 
being requested about the SCCS Facility. The arguments 
may be either message numbers (which normally appear in 
parentheses following messages) or command names, of one 
of the following types: 
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typel Begins with non-numerics, ends in numerics. The 
non-numeric prefix is usually an abbreviation 
for the program or set of routines which pro- 
duced the message (e.g., ge3 for message 3 from 
the get(C) conmiand). 

type2 Does not contain numerics (as a command, such 
as get). 

type3 Is all numeric (e.g., 212). 



See Also 

glossary(C), locate(C), sh(C), starter(C), usage(C), 
term(M) profile(M), and admin(S), cdc(S), comb(S), 
delta(S), get(S), prs(S), rmdel(S), sact(S), sccsdiff(S), 
unget(S), val(S), vc(S), what(S), sccsfile(F) in the Ref- 
erence (CP, S, F) 



Warnings 

If the shell variable TERM (see sh(C)) is not set in the 
user's .profile file, then TERM will default to the ter- 
minal value type 450 (a hard-copy terminal). For a list 
of valid terminal types, refer to term(M). 
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Name 

hplp - Filters files for printing on HP Laserjet. 

hplpR - Filters and reverses pages for printing on HP 
Laserjet. 



Syntax 

hplp [ file ... ] 
hplpR [-w] [ file ... ] 



Description 

These commands filter files for printing on the Hewlett- 
Packard Laserjet printer. If no files are given, both 
commands will read from the standard input. Both commands 
write the output to the standard output (screen), and are 
normally run as part of a pipeline: 

hplp file I IpriV 

Hplp simply prepends the command sequences that enable the 
printing of a full 66 lines by 80 columns on standard 8 
1/2 X 11 paper (without putting lines in the "unprintable" 
regions of the paper). 

HplpR will reverse the pages in a file, so that when they 
are actually printed, they will be correctly collated in 
the output tray. A maximum of 256 pages can be reversed. 
It is assumed that all pages are 66 lines, so documents 
formatted for other page lengths may not be handled cor- 
rectly. If a formfeed (octal 014) is found, it terminates 
a page, allowing correct reversal of short pages. 

-w Prints wide documents (hplpR). The -w option sends 
the command sequences that request "landscape mode" 
printing (rotated 90 degrees), and that use 17 pitch 
characters. This allows printing of pages with a 
full 66 lines by 170 columns. 



Files 

/usr/bin/hplp 
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Name 

id - Prints user and group IDs and names. 

Syntax 
id 

Description 

Id outputs the user and group IDs and the corresponding 
names of the invoking process. If the effective and real 
IDs are different, both are printed. 

See Also 

getuid(S), logname(C) 
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Name 



ipcrm - Removes a message queue, semaphore set, or shared 
memory id. 



Syntax 

ipcrm [ options ] 



Description 



Ipcrm will remove one or more specified messages, sema- 
phore or shared memory identifiers. The identifiers are 
specified by the following options: 



-m shmid Removes the shared memory identifier shmid 

from the system. The shared memory seg- 
ment and data structure associated with it 
are destroyed after the last detach. 

-M shmkey Removes the shared memory identifier, 

created with key shmfeey, from the system. 
The shared memory segment and data struc- 
ture associated with it are destroyed after 
the last detach. 



-q msqid Removes the message queue identifier msqia 

from the system and destroys the message 
queue and data structure associated with 
it. 



-Q msgkey Removes the message queue identifier, 

created with key msgfeey, from the system 
and destroys the message queue and data 
structure associated with it. 

-s semid Removes the semaphore identifier semid frc 

the system and destroys the set of sema- 
phores and data structure associated with 
it. 



-S semkey Removes the semaphore identifier, created 
with key semkey, from the system and de- 
stroys the set of semaphores and data 
structure associated with it. 
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The details of the removes are described in msgctl(S), 
shmctl(S), semctKS). The identifiers and keys may be 
found by using ipcs(C). 



See Also 

ipcs(C) and msgctl(S), msgget(S), msgop(S), semctl(S), 
semget(S), semop(S), shmctl(S), shmget(S), shmop(S) in the 
Reference (CP, S, F) 
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Name 

ipcs - Reports inter-process communication facilities 
status. 



Syntax 

ipcs [ options ] 



Description 

Ipcs prints certain information about active inter-process 
communication facilities. Without options, information is 
printed in short format for message queues, shared memory, 
and semaphores that are currently active in the system. 
Otherwise, the information that is displayed is controlled 
by the following options. 



Options 

-m Print information about active shared memory seg- 
ments. 

-q Print information about active message queues. 

-s Print information about active semaphores. 

If any of the options -m, -q, or -s are specified, infor- 
mation about only those indicated will be printed. If 
none of these three are specified, information about all 
three will be printed subject to these options: 

-a Use all print options. (This is a shorthand notation 
for -b, -c, -o, -p, and -t.) 

-b Print biggest allowable size information. (Maximum 
number of bytes in messages on queue for message 
queues, size of segments for shared memory, and num- 
ber of semaphores in each set for semaphores.) See 
the following for meaning of columns in a listing. 

-c Print creator's login name and group name. See the 
following description. 
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-C corefile 

Use the file corefile in place of /dev/kmem. 
-N namelist 

The argument will be taken as the name of an alter- 
nate namelist (/unix is the default). 

-o Print information on outstanding usage. (Number of 
messages on queue and total number of bytes in mes- 
sages on queue for message queues and number of pro- 
cesses attached to shared memory segments.) 

-p Print process number information. (Process ID of 

last process to send a message and process ID of last 
process to receive a message on message queues and 
process ID of creating process and process ID of last 
process to attach or detach on shared memory 
segments). See the following description. 

-t Print time information. (Time of the last control 

operation that changed the access permissions for all 
facilities. Time of last msgsnd and last msgrcv on 
message queues, last shmat and last shmdt on shared 
memory, last semop on semaphores.) See the following 
description. 

The column headings and the meaning of the colunms in an 
ipes listing follow; the letters in parentheses indicate 
the options that cause the corresponding heading to ap- 
pear; "all" means that the heading always appears. Note 
that these options only determine what information is pro- 
vided for each facility; they do not determine which f- 
acilities will be listed. 

T (all) 

Type of the facility: 

m Shared memory segment; 
q Message queue; 
s Semaphore. 

ID (all) 

The identifier for the facility entry. 
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KEY (all) 

The key used as an argument to msgget^ 
semgett or shmget to create the facility 
entry. (Note: The key of a shared mem- 
ory segment is changed to IPC_PRIVATE 
when the segment has been removed until 
all processes attached to the segment de- 
tach it.) 

MODE (all) 

The facility access modes and flags: The 
mode consists of 11 characters that are 
interpreted as follows: 

The first two characters are: 

C if the associated shared memory seg- 
ment is to be cleared when the first 
attach is executed; 

D if the associated shared memory seg- 
ment has been removed. It will disap- 
pear when the last process attached t( 
the segment detaches it; 

R if a process is waiting on a msgrev; 

S if a process is waiting on a msgsnd; 

if the corresponding special flag is 
not set. 

The next 9 characters are interpreted as 
three sets of three bits each. The first 
set refers to the owner's permissions; the 
next to permissions of others in the 
user-group of the facility entry; and the 
last to all others. Within each set, the 
first character indicates permission to 
read, the second character indicates per- 
mission to write or alter the facility en- 
try, and the last character is currently 
unused. 
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OWNER 



GROUP 



CGROUP 



CBYTES 



QNUM 



QBYTES 



LSPID 



The permissions are indicated as follows: 

a if alter permission is granted; 

r if read permission is granted; 

w if write permission is granted; 

if the indicated permission is not 
granted. 



(all) 



The login name of the owner of the facility 
entry. 



(all) 



The group name of the group of the owner 
of the facility entry. 



CREATOR (a,c) 



The login name of the creator of the 
facility entry. 



(a,c) 



The group name of the group of the creator 
of the facility entry. 



(a,o) 



The number of bytes in messages currently 
outstanding on the associated message 
queue. 



(a,o) 



The number of messages currently 
outstanding on the associated message 
queue. 



(a,b) 



The maximum number of bytes allowed in 
messages outstanding on the associated 
message queue. 



(a,p) 



The process ID of the last process to send 
a message to the associated queue. 
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LRPID 



STIME 



RTIME 



CTIME 



SEGSZ 



CPID 



LPID 



ATIME 



DTIME 



NSEMS 



(a,p) 



The process ID of the last process to 
receive a message from the associated 
queue. 



(a,t) 



The time the last message was sent to the 
associated queue. 



(a,t) 



The time the last message was received fror 
the associated queue. 



(a,t) 



The time when the associated entry was 
created or changed. 



NATTCH (a,o) 



The number of processes attached to the 
associated shared memory segment. 



(a,b) 



The size of the associated shared memory 
segment. 



(a,p) 



The process ID of the creator of the sharec 
memory entry. 



(a,p) 



The process ID of the last process to 
attach or detach the shared memory segmen 



(a,t) 



The time the last attach was completed to 
the associated shared memory segment. 



(a,t) 



The time the last detach was completed on 
the associated shared memory segment. 



(a,b) 



The number of semaphores in the set 
associated with the semaphore entry. 
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OTIME {a,t) 

The time the last semaphore operation was 
completed on the set associated with the 
semaphore entry. 



Files 

/unix System namelist 

/dev/kmem Memory 

/etc/passwd User names 

/etc/group Group names 



See Also 

msgop(S), semop(S), shmop(S) in the Reference Manual 
(CP, S, F) 



Notes 

Things can change while ipes is running; the picture it 
gives is only a close approximation to reality. 
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Name 

join - Joins two relations. 



Syntax 

join [ options ] filel file2 



Description 

Join forms, on the standard output, a join of the two re- 
lations specified by the lines of filel and file2. If 
filel is -, the standard input is used. 

Filel and file2 must be sorted in increasing ASCII collat- 
ing sequence on the fields on which they are to be joined, 
normally the first in each line (see sort{C)). 

There is one line in the output for each pair of lines in 
filel and file2 that have identical join fields. The out- 
put line normally consists of the common field, then the 
rest of the line from filel , then the rest of the line 
from file2. 

The default input field separators are blank, tab, or new- 
line. In this case, multiple separators count as one 
field separator, and leading separators are ignored. The 
default output field separator is a blank. 

Some of the options below use the argument n. This argu- 
ment should be a 1 or a 2 referring to either filel or 
file2y respectively. The following options are recog- 
nized: 

-an In addition to the normal output, produce a line 

for each unpairable line in file n, where n is 1 
or 2. 

-e s Replace empty output fields by string s. 

-jn m Join on the mth field of file n. If n is 

missing, use the mth field in each file. Fields 
are numbered starting with 1. 
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-o list 



Each output line comprises the fields specified 
in listy each element of which has the form n.m, 
where n is a file number and m is a field num- 
ber. The common field is not printed unless 
specifically requested. 



-tc 



Use character c as a separator. Every appear- 
ance of c in a line is significant. The charac- 
ter c is used as the field separator for both 
input and output. 



Example 



The following command line will join the password file and 
the group file, matching on the numeric group ID, and out- 
putting the login name, the group name and the login di- 
rectory. It is assumed that the files have been sorted in 
ASCII collating sequence on the group ID fields. 

join -jl 4 -j2 3 -o 1.1 2.1 1.6 -t: /etc/passwd /etc/group 



With default field separation, the collating sequence is 
that of sort -b; with -t, the sequence is that of a plain 
sort. 

The conventions of join(C), sort(C), comm(C), uniq(C), and 
awk(C) are wildly incongruous. 

Filenames that are numeric may cause conflict when the -o 
option is used right before listing filenames. 



See Also 



awk(C), comin(C), sort(C), uniq(C) 



Notes 
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Name 

kill - Terminates a process. 



Syntax 

kill [ -signo ] PID... 



Description 

Kill sends signal 15 (terminate) to the specified pro- 
cesses. This will normally kill processes that do not 
catch or ignore the signal. The process number of each 
asynchronous process started with & is reported by the 
shell (unless more than one process is started in a pipe- 
line, in which case the number of the last process in the 
pipeline is reported). Process numbers can also be found 
by using ps(C). 

The details of the kill are described in kill(S). For 
example, if process number 0 is specified, all processes 
in the process group are signaled. 

The killed process must belong to the current user unless 
he is the super-user. If a signal number preceded by - is 
given as the first argument, that signal is sent instead 
of terminate (see signal(S)). In particular kill -9 PID 
is a sure kill. 



See Also 

ps(C), sh(C), and kill(S), signal(S) in the Reference (CP, 
S, F) 
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Name 

killall - Kills all active processes. 

Syntax 

/etc/killall [signal] 

Description 

Killall terminates all active processes not directly re- 
lated to the shutdown procedure. Killall is used by 
/etc/shutdown, and can only be run by the super-user. 

Killall terminates all processes with open files so that 
the mounted file systems will be unbusied and can be un- 
mounted. 

Killall sends signal (see kill(C)). The default signal 
is 9. 

Files 

/etc/shutdown 

See Also 

kill(C), ps(C), shutdown(C) 
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Name 

labelit - Provides labels for file systems. 



Syntzix 

/etc/labelit special [ fsname volume [ -n ] ] 



Description 

Use labelit to provide labels for unmounted disk file sys- 
tems or file systems being copied to tape. 

-n Provides for initial labeling only (this destroys 
previous contents). 

With the optional arguments omitted, labelit prints cur- 
rent label values. 

The special name should be the physical disk section 
(e.g., /dev/hdOb), or the cartridge tape (e.g., /dev/rct). 
The device may not be on a remote machine. 

The fsname argument represents the mounted name (e.g., /, 
/usr2, etc.) of the file system. 

Volume may be used to equate an internal name to a volume 
name applied externally to the disk pack, diskette or 
tape. 

For file systems on disk, fsname and volume are recorded 
in the superblock. 



See Also 
sh(C) 
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Name 

last - Indicates last logins of users and terminals. 



Syntax 

last [-f file] [-t ttynn...] [name,.,] 



Description 

The last command looks in the wtmp file (where every login 
and logout is recorded) for information about a user, a 
terminal, or any group of users and terminals. Other ar- 
guments specify names of users or terminals. 

The last command displays the sessions of the specified 
users and terminals, most recent first, indicating the 
times the session began, the duration, and terminals used. 
The last command indicates if the session was cut short by 
a reboot. There is a pseudo-user "reboot" that is logged 
in each time the system reboots. So the command: 

last reboot 

gives an indication of mean time between reboot. 

For multiple arguments, information applying to any of the 
arguments is printed. For example, 

last root croot 

lists all of root's sessions as well as all of croot' s 
sessions. 

last -t tty02 console 

lists all logins on tty02 and console. 

If the last command is issued with no arguments, a record 
of all logins and logouts are displayed in reverse order. 
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Options 

-f file Specifies an alternate wtmp file. 

-t ttynn Lists the logins on the named terminal (separate 
terminal names with a space). 

Related Commands 
utmp(M) 

See Also 

/usr/adm/wtmp Login data base 
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Name 

leave - Reminds you when you have to leave. 



Syntax 

leave [ hhmm ] 



Description 

Leave waits until the specified time, then reminds you 
that you have to leave. You are reminded five minutes and 
one minute before the actual time, at the time, and every 
minute thereafter. When you log off, leave exits just 
before it would have printed the next message. 

The time of day is in the form hhmm where hh is a time in 
hours (on a 12 or 24 hour clock). All times are converted 
to a 12 hour clock, and assumed to be in the next 12 
hours. 

If no argument is given, leave prompts with "When do you 
have to leave?" A reply of newline causes leave to exit, 
otherwise the reply is assumed to be a time. This form is 
suitable for inclusion in a .login or .profile. 

Leave ignores interrupts, quits, and terminates. To get 
rid of it you should either log off or use "kill -9" 
giving its process id. 



See Also 

calendar(C) 
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Name 

line - Reads one line of input. 

Syntax 
line 

Description 

Line copies one line (up to a newline) from the standard 
input and writes it on the standard output. It returns an 
exit code of 1 on end-of-file and always prints at least a 
newline. It is often used within shell files to read from 
the user's terminal. 

See Also 

gets(C), sh(C), and read(S) in the Reference (CP, S, F) 
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Name 

In - Makes a link to a file. 



Syntax 

In [options] filel file2 

In [options] filel ... filen directory 



Description 

A link is a directory entry referring to a file; the same 
file (together with its size, all its protection informa- 
tion, etc.) may have several links to it. There is no way 
to distinguish a link to a file from its original direc- 
tory entry. Any changes to the file are effective inde- 
pendent of the name by which the file is known. 

Ln creates a link to the existing file, filel. The file2 
argument is a new name referring to the same file contents 
as filel. If the last argument is a directory, links to 
filel ... filen will be made in directory. 

Ln has the following options: 

-f Makes the link even if fUe2 already exists (by first 
unlinking file2). 

-s Makes a sjnnbolic link to a file. A symbolic link 
differs from a regular link in that it is a separate 
inode on disk that points to another file. The tar- 
get of a sjmibolic link may be on a different file 
system, or even on a different machine if the network 
is in use. 

S57mbolic links can nest three deep. That is, if W is a 
file, X may be symbolically linked to W, Y to X, and Z to 
Y. However, if ZZ is sjnnbolically linked to Z, attempting 
to access ZZ will fail. 
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See Also 

cp(C), ls(C), inv(C), rm(C), and syinlink(S) in the 
Reference (CP, S, F) 

I 

Notes 

You cannot make a hard link to a directory or across file 
systems. 
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Name 

login - Gives you access to the system. 



Syntax 

login [ name [ env-var,.. ]] 



Description 

The login command is used at the beginning of each termi- 
nal session and allows you to identify yourself to the 
system. It may be invoked as a command or by the system 
when a connection is first established. Also, it is in- 
voked by the s ystem when a previous user logs out by typ- 
ing a ■tHiPiM. 

If login is invoked as a command it must replace the ini- 
tial command interpreter. This is accomplished by typing: 

exec login 

from the initial shell. 

Login asks for your user name (if not supplied as an 
argument), and, if appropriate, your password. Echoing is 
turned off (where possible) during the typing of your 
password, so it will not appear on the written record of 
the session. 

At some installations, an option may be invoked that will 
require you to enter a second "dialup" password. This 
will occur only for dial-up connections, and will be 
prompted by the message "dialup password:". Both pass- 
words are required for a successful login. 

If you do not complete the login successfully within a 
certain period of time (e.g., one minute), you are likely 
to be silently disconnected. 

After a successful login, accounting files are updated, 
the procedure /etc/profile is performed, the 
message-of-the-day, if any, is printed, the user-ID, the 
group-ID, the working directory, and the command inter- 
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preter (usually sh(C)) are initialized, and the file 
•profile in the working directory is executed, if it 
exists. 

These specifications are found in the /etc/passwd file 
entry for the user. The name of the command interpreter 
is - followed by the last component of the interpreter's 
path name (e.g., -sh). If this field in the password file 
is empty, then the default command interpreter, /bin/sh is 
used. If this field is "*", then the named directory be- 
comes the root directory, the starting point for path 
searches for path names beginning with a /. At that 
point, login is re-executed at the new level which must 
have its own root structure, including /etc/login and 
/etc/passwd. 

The basic environment is initialized to: 

HOME=your-login-directory 
PATH=:/bin:/usr/bin 
SHELL=last-field-of-passwd-entry 
MAlL=/usr/mail/youT-login-name 
TZ=time zone-specification 

The environment may be expanded or modified by supplying 
additional arguments to login, either at execution time or 
when login requests your login name. The arguments may 
take either the form xxx or xxx=yyy. Arguments without an 
equal sign are placed in the environment as: 

Ln=xxx 

where n is a number starting at 0 and is incremented each 
time a new variable name is required. Variables contain- 
ing an = are placed into the environment without modifica- 
tion. If they already appear in the environment, then 
they replace the older value. There are two exceptions. 
The variables PATH and SHELL cannot be changed. This 
prevents users, logging into restricted shell environ- 
ments, from spawning secondary shells that are not re- 
stricted. Both login and getty(M) understand simple 
single-character quoting conventions. Typing a backslash 
in front of a character quotes it and allows the inclusion 
of such things as spaces and tabs. 
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FUes 



/etc/utmp 

/etc/wtmp 

/usr/mail/your-namc 

/etc/motd 

/etc/passwd 

/etc/profile 

profile 



Accounting 
Accounting 

Mailbox for user your-name 
Message-of-the-day 
Password file 
System profile 
User's login profile 



See Also 



mail(C), newgrp(C), sh(C), environ(M), getty(M), su(M), 
passwd(M), profile (M) 



Diagnostics 

login incorrect 

The user name or the password cannot be matched. 

No shelU cannot open password file^ or no directory 

There is an error in the password file, /etc/passwd. 

No utmp entry. You must exec "login" from the lowest 
level shell 

You attempted to execute login as a command without 
using the shell's internal exec command or from a 
subshell. 
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Name 

logname - Gets login name. 

Syntax 

logname 

Description 

Logname returns the user's login name as set when the 
user logs into the system. 

See Also 

env(C), environ(M), login(C), and logname(S) in the 
Reference (CP, S, F) 
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Name 

look - Finds lines in a sorted list. 
Syntax 

look [ -df ] [ -tc ] string [ file ] 
Description 

Look consults a sorted file and prints all lines that be- 
gin with string. It uses binary search. 

The -d and -f options affect comparisons as in sort(C): 

-d Dictionary order: only letters, digits, tabs, and 
spaces are compared. 

-f Fold: uppercase letters compare equally to lowercase 
letters. 

-tc Specify an alternate tab character (word separator), 
c. 

If no file is specified, /usr /diet/ words is assumed with 
the collating sequence, -df. 

Files 

/usr/dict/words 

See Also 

grep(C), sort(C) 
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Name 

Ip, cancel - Sends/cancels requests to an LP line printer. 



Synt£ix 

Ip [ -c ] [ -ddest ] [ -m ] [ -nnumber ] [ -ooption ] 

[ -s ] [ -ttitle ] [ -w ] file ... 
cancel [ ids ] [ printer ... ] 



Description 

Lp arranges for the named files and associated information 
(collectively called a request) to be printed by a line 
printer. If no file names are mentioned, the standard 
input is assumed. The file name - (the standard input) 
may also be supplied on the command line along with named 
files. The order in which the files appear is the same 
order in which they will be printed. 

Lp associates a unique id with each request and prints it 
on the standard output. This id can be used later to can- 
cel (see cancel below) or find the status (see Ipstat(C)) 
of the request. 



Options 

-c Make copies of the files to be printed immedi- 

ately when lp is invoked. For RFS, you must 
specify -c, which copies the files to 
/usr/spool/lp/request /prin tername. Normally, 
the files will not be copied, but will be linked 
whenever possible. If the -c option is not 
given, then be careful not to remove any of the 
files before the request has been printed in its 
entirety. It should also be noted that in the 
absence of the -c option, any changes made to 
the named files after the request is made but 
before it is printed will be reflected in the 
printed output. 
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NOTE 

You must specify -c when printing across an 
RFS network. 



-6.dest Choose dest as the printer or class of printers 
that is to do the printing. If dest is a 
printer, then the request will be printed only 
on that specific printer. If dest is a class of 
printers, then the request will be printed on 
the first available printer in that class. 
Under certain conditions (printer unavailabil- 
ity, file space limitation, etc.), requests for 
specific destinations may not be accepted. By 
default, dest is taken from the environment var- 
iable LPDEST (if it is set). Otherwise, a de- 
fault destination (if one exists) for the com- 
puter system is used. Destination names vary 
between systems. 

-m Send mail (see mail(C)) after printing the 

files. By default, no mail is sent upon normal 
completion of the print request. 

-nnumbeT Print number copies (default of 1) of the out- 
put. 

-ooption Specify printer-dependent or class-dependent 

options. Several such options may be collected 
by specifying the -o keyletter more than once. 

-s Suppress messages from Ip such as "request id is 



-ttitle Print title on the banner page of the output. 

-w Write a message on the user's terminal after 

printing the files. If the user is not logged 
in, sends mail instead. 



Cancel cancels line printer requests that were made by the 
Ip command. The command line arguments may be either re 
quest ids (as returned by Ip) or printer names (see Ipstat 
for a list of names). Specifying a request id cancels the 
associated request even if it is currently printing. 
Specifying a printer cancels the request which is cur- 
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rently printing on that printer. In either case, cancelling 
a request that is curerntly printing frees the printer to 
print its next available request. 

If you attempt to print with Ip a file that is not read- 
able by others or is in a directory not accessible by 
others, then you must use one of the following sjmtaxes to 
print such a file with Ip: 

cat file I Ip 
Ip < file 

If your system uses Ipr instead of Ip, these restrictions 
do not apply. 



Files 

/usr/spool/lp/* 



See Also 

Ipadmin(M), Ipenable(C), Ipinit(M), Ipstat(C), mail(C), 
accept(C), Ipsched(M), Operations Guide 
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Name 

Ipenable, Ipdisable - Enables/disables LP printers. 



Syntax 

Ipenable printer ... 

Ipdisable [-c] [-r[reason]] printer ... 



Description 

Lpenable activates the named printers to print requests 
taken by lp(C). Use Ipstat(C) to find the status of the 
printers. 

Ipdisable deactivates the named printers, disabling them 
from printing requests taken by lp(C). By default, any 
requests that are currently printing on the designated 
printers will be reprinted in their entirety either on the 
same printer or on another member of the same class. Use 
Ipstat(C) to find the status of printers. 

Options useful with Ipdisable are: 

-c Cancel any requests that are currently 

printing on any of the designated printers. 

-r[reason] Associates a reason with the deactivation 

of the printers. This reason applies to 
all printers mentioned up to the next -r 
option. If the -r option is not present or 
the -r option is given without a reason, 
then a default reason will be used. Reason 
is reported by Ipstat(C). 



Files 

/usr/spool/lp/* 



See Also 

lp(C), Ipstat(C) 
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Name 

Ipr - Routes named files to printer spooler. 



S5nit£ix 

Ipr [-b[x]] [-k] [-mUogin]] [-n] [-metname]] [-pfe] [-r] 
[sconf] [Smodes] file name(s) 



Description 

The Ipr command routes the named files to the printer you 
specify. (See "Notes" for restrictions.) There are sev- 
eral options that you can add to the Ipr command so it 
will do more than route the files to a printer. 

Most of these options have an associated environment vari- 
able and a corresponding field in a configuration file 
line (see printers(M)). Command-line arguments have pre- 
cedence over environment variables, and environment vari- 
ables override configuration file fields. 



NOTE 

Beginning with Altos System V, Release 5.3d, 
the Ipr program is a filter for (calls) the 
Ip program. It no longer processes the -N and 
-S options. See the description of Ip in the 
OpeTations Guide for information on how to set 
up a printer interface program. 



Options 

-bx Adds a banner page at the beginning of a 

print job. The x argument (4 characters 
maximum) supplies the text of the header. 
Use of this option overrides the BANNER 
environment variable, which tells Ipd and 
Ipr that BANNER is the name used in the 
header page attached to your job. 
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If you use the -b option without defining 
X, and the BANNER environment variable is 
undefined, the spooler will use your login 
name. 

If you specify -b, the banner page is 
printed, then the print job, and a form- 
feed is supplied after the print job is 
finished. If no banner is desired, print- 
ing begins at the current position of the 
printhead (no initial formfeed), and a page 
is ejected after printing is completed. 

-m[ login] Sends you mail when a printer job has com- 

pleted. If you specify a login name, the 
specified user is notified; otherwise, the 
-m option alone sends a message to the re- 
questor. 

-N Suppresses the formfeed after each page. 

-@[netname] Specifies a WorkNet computer name other 
than your local machine. 

When you use this option, the files you 
want to print are copied to spool director- 
ies on the named machine. A print daemon 
(see the Ipd command) is remotely invoked 
to do the actual printing. If no machine 
name is specified, printing is assimied to 
be local. 

-pn Where n is a number that represents the 

printer device. If you don't use this op- 
tion, the print spooler checks the environ- 
mental variable PRINTER for the printer 
device number. If PRINTER is not defined, 
the spooler checks the configuration file. 

The default printer spool directory is 
/usr/spool/lpd and the default printer de- 
vice is /dev/lp. If printer 1 is selected, 
the spool directory is /usr/spool/lpdl, and 
device /dev/lpl. 
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As an alternative, you can supply the 
printer number as part of the Ipr name, 
(for example, Iprl [-optionl] [option2] 
...). The -p option overrides a printer 
digit supplied from the file name. 

Removes a file from the home directory 
after printing. 

Selects a printer configuration line from 
the printer configuration file (see the 
miscellaneous file printers in the next 
section). Conf is the name of the con- 
figuration line you select from the config- 
uration file. You can also use the en- 
vironmental variable PCONF to select the 
configuration line you want. 

-Smodes Supplies baud and other tty modes for 

serial printers. The modes argument con- 
sists of a set of tty modes, enclosed in 
quotes. For example, -81 200 selects 1200 
as the baud rate for this print request. 
This option overrides a mode selection from 
the configuration file. You can also use 
the environment variable PMODES to supply 
this information. 

If you specify a configuration line name, and no printer 
device, the print spooler uses the first line in the 
printer configuration file that matches that name. The 
spooler then takes the printer device digit from the cor- 
responding field in the same line. 

If you specify a configuration line name and a printer 
device, the print spooler uses the first line in the 
printer configuration file that matches both printer de- 
vice and name fields. 

If you specify a printer device only, or if the spooler is 
invoked as "Ipr," the first line that matches the printer 
device is used. The printer device defaults to /dev/lp if 
no configuration file lines are selected, or if no config- 
uration file exists. 



-r 

-sconf 
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Examples 

This command prints the file lemons on the local printer, 
and sends you a message when the print job is finished. 

Ipr -m lemons BrfJIW 

This command queues the file lemons to be printed from 
spool directory /usr/spool/lpd2 on printer /dev/lp2 at a 
speed of 1200 baud. 

Ipr -SI 200 -p2 lemons |SSSI 

This command prints the file lemons on the default printer 
of the computer machine 1 in your network, and sends user 
Chris a message when the print job is finished. 

Ipr -mchris -©machine 1 lemons ISS&l 



Files 



/usr/spool/lpd* Spooling directories 

/dev/lp* Line printer devices 

/usr/lib/lpd Line printer daemon 

/etc/printers Printer configuration file 



See Also 

maiKC), Ipd(M), lp(C), printers(M) 



Notes 

For Unix System V compatibility on the Altos 386 Series 
500 and software release 5.3d and later, Ipr executes Ip 
and its associated commands. 
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Name 

Ipstat - Prints LP status information. 



Syntax 

Ipstat [ options ] [requestid.,.] 



Description 

Lpstat prints information about the current status of the 
LP line printer system. 

If no options are given, then Ipstat prints the status of 
all requests made to lp(C) by the user. Any argument that 
is not an option is assumed to be a requestid^ which is a 
unique id that lp(C) associates with each request. Lpstat 
prints the status of such requests. 



Options 

Options may appear in any order and may be repeated and 
mixed with other arguments. Some of the keyletters below 
may be followed by an optional list that can be in one of 
two forms: 

• A list of items separated from one another by a comma 

• A list of items enclosed in double quotes and sepa- 
rated from one another by a comma and/or one or 
more spaces. 

For example: 

-u"userl, user2, userS" 

The omission of a list following such keyletters causes 
all information relevant to the keyletter to be printed. 
For example: 

Ipstat -o 

prints the status of all output requests. 
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All options listed below apply to a Worknet network. In 
addition, local/remote refers to local/remote machines in 
an RFS network. 



-a[h*sf] Print acceptance status (with respect to Ip) of 
destinations for requests. List is a list of 
mixed printer names and class names. RFS 
local/remote. 

-c[list] Print class names and their members. List is a 
list of class names. RFS local. 

-d Print the system default destination for Ip. 

The destination can be local/remote. 

-o[h*st] Print the status of output requests. List is a 
list of mixed printer names, class names, and 
request ids. RFS local/remote. 

-pEh'st] Print the status of printers. list is a list of 
printer names. RFS local/remote. 

-r Print the status of the LP request scheduler. 

RFS local. 



-s Print a status summary, including the system 

default destination, a list of class names and 
their members, and a list of printers and their 
associated devices. RFS local. 

-t Print all status information. RFS local. 



-u[h'st] Print status of output requests for users. List 
is a list of login names. RFS local. 

-v[hst] Print the names of printers and the path names 
of the devices associated with them. List is a 
list of printer names. RFS local/remote. 



Files 



/usr/spool/lp/* 



See Also 



Ipenable(C), lp(C) 
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Name 

Is - Lists contents of a directory. 



Syntax 

Is [ options ] [ name ... ] 
1 

Ic 
If 
U 
Ir 
Ix 



Description 

For each directory argument. Is lists the contents of the 
directory; for each file argument, Is repeats its name and 
any other information requested. The output is sorted 
alphabetically by default. When no argument is given, the 
current directory is listed. When several arguments are 
given, the arguments are first sorted appropriately, but 
file arguments appear before directories and their con- 
tents. Lc, If, 11, Ir, and Ix abbreviate Is -C, is -F, is 
-1, is -R and Is -x, respectively. 

The Is command has the following options: 

-A List all entries including those that begin with a 
dot except "." and 

-a List all entries, including those that begin with a 
dot (.), which are normally not listed. 

-b Force printing of non-printing characters to be in 
the octal \ddd notation. 

-C Multi-column output with entries sorted down the 
columns. 

-c Use time of creation of the inode for sorting (-t). 

-d If an argument is a directory, list only its name 
(not its contents); often used with -1 to get the 
status of a directory. 
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-F Put a slash (/) after each filename if that file is a 
directory and put an asterisk (*) after each filename 
if that file is executable. This is the same as typ- 
ing If. 

-f Force each argument to be interpreted as a directory 
and list the name found in each slot. This option 
turns off -1, -t, -s, and -r, and turns on -a; the 
order is the order in which entries appear in the 
directory. 

-g The same as -1, except that the owner is not printed. 

-i For each file, print the inode number in the first 
column of the report. 

-L Mark directories or files with a trailing ">" if they 
are sjTmbolic links and the -1 option is not used. If 
-1 is used, list the name of the file to which it is 
symbolically linked. 

-1 List in long format, giving mode, number of links, 
owner, group, size in bytes, and time of last modifi- 
cation for each file (see below). If the file is a 
special file, the size field will instead contain the 
major and minor device numbers rather than a size. 

-m Stream output format; files are listed across the 
page, separated by commas. 

-n The same as -1, except that the owner's UID and 

group's GID numbers are printed, rather than the as- 
sociated character strings. 

-o The same as -1, except that the group is not printed. 

-p Put a slash (/) after each filename if that file is a 
directory. 

-q Force printing of non-printing characters in file 
names as the character (?). 

-R Recursively list subdirectories encountered. 

-r Reverse the order of sort to get reverse alphabetic 
or oldest first as appropriate. 
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-s Give size in blocks, including indirect blocks, for 
each entry. 

-t Sort by time stamp (latest first) instead of by name. 
The default is the last modification time. (See -u 
and -c.) 

-u Use time of last access instead of last modification 
for sorting (with the -t option) or printing (with 
the -1 option). 

-X Multi-column output with entries sorted across rather 
than down the page. 

-1 List only one (1) entry per line, even if output is 
to a terminal. This is the default when output is 
not to a terminal. 

The mode printed under the -1 option consists of ten char- 
acters. The first character may be one of the following: 

b the entry is a block special file 

c the entry is a character special file 

d the entry is a directory 

1 the entry is a symbolic link 

m the entry is a shared memory special file 

p the entry is a fifo (a.k.a. "named pipe") special file 

s the entry is a semaphore file 

the entry is an ordinary file 

The next 9 characters are interpreted as three sets of 
three bits each. The first set refers to the owner's per- 
missions; the next to permissions of others in the user- 
group of the file; and the last to all others. Within 
each set, the three characters indicate permission to 
read, to write, and to execute the file as a program, re- 
spectively. For a directory, "execute" permission is in- 
terpreted to mean permission to search the directory for a 
specified file. 

Is -1 (the long list) prints its output as follows: 

-rwxrwxrwx 1 smith dev 10876 May 16 9:42 part2 

This horizontal configuration provides a good deal of in- 
formation. Reading from right to left, you see that the 
current directory holds one file, named "part2." Next, the 
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last time that file's contents were modified was 9:42 A.M. 
on May 16. The file is moderately sized, containing 
10,876 characters, or bytes. The owner of the file, or 
the user, belongs to the group "dev" (perhaps indicating 
"development"), and his or her login name is "smith." The 
number, in this case "1," indicates the number of links to 
file "part2." Finally, the row of dashes and letters tell 
you that user, group, and others have permissions to read, 
write, execute "part2." 

The execute (x) symbol here occupies the third position of 
the three-character sequence. A - in the third position 
would have indicated a denial of execution permissions. 

The permissions are indicated as follows; 

r The file is readable 

w The file is writable 

X The file is executable 

The indicated permission is not granted 

s The set-user-ID or set-group-ID bit is on, and the 
corresponding user or group execution bit is also on 

S The set-user-ID bit or set-group-ID bit is on and the 
corresponding execution bit is off 

t The 1000 (octal) bit, or sticky bit, is on (see 
chmod(C)), and execution is on 

T The 1000 bit is turned on, and execution by others is 
off 

For user and group permissions, the third position is 
sometimes occupied by a character other than x or -. s 
also may occupy this position, referring to the state of 
the set-ID bit, whether it be the user's or the group's. 
The ability to assume the same ID as the file owner during 
execution is, for example, used by the passwd command to 
allow you to update your password file entry, normally 
writeable only by the super-user. 

For others permissions, the third position may be occupied 
by t or T. These refer to the state of the sticky bit and 
execution permissions. 
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Examples 



The first set of examples refers to permissions: 
-rwxr~r— 

This describes a file that is readable, writable, and exe- 
cutable by the user and readable by the group and others. 

-rwsr-xr-x 

The second example describes a file that is readable, 
writable, and executable by the user, readable and execut- 
able by the group and others, and allows its user-ID to be 
assumed, during execution, by the user presently executing 
it. 



This command will print the names of all files in the cur- 
rent directory, including those that begin with a dot (.), 
which normally do not print. 



This command will provide you with quite a bit of informa- 
tion including all files, including non-printing ones (a), 
the i-number~the memory address of the i-node associated 
with the file—printed in the left-hand colunm (i); the 
size (in blocks) of the files, printed in the column to 
the right of the inumbers (s); finally, the report is dis- 
played in the numeric version of the long list, printing 
the UID (instead of user name) and GID (instead of group 
name) numbers associated with the files. 

When the sizes of the files in a directory are listed, a 
total count of blocks, including indirect blocks, is 
printed. 



Is -a 



is -aisn 



Files 



/etc/passwd 

/etc/group 

/usr/lib/terminfo/?/* 



User IDs for is -1 and Is -o 
Group IDs for Is -1 and is -g 
Terminal information database 
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See Also 

chmod(C), find(C) 

Notes 

Unprintable characters in file names may confuse the 
columnar output options. 
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Name 

mail - Sends or receives mail among users. 



Syntax 



maU [user ...] 
maU [-f file] [-pr] 



Description 

The mail command (/bin/mail) is used both to send mail to 
other users, and to read mail that has been sent to you. 
When you log in, the sjTStem tells you if you have mail. 

There are several options you can use with the mail com- 
mand to print, delete, and store mail. 



Options 



When you see the "You have mail" message, read your mail 
by entering: 

mail BH/JiliM 



You can use any of the following arguments with the mail 
command: 

-f [file] Causes the named file to be displayed in 

mail format. 

-p Causes the mail to be printed on your 

printer. 

-r Causes the oldest message to appear first. 

Without this option, the most current mes- 
sage appears first. 

You can enter the following at the prompt: 

Ur/jjl'ill Goes on to the next message 

d Deletes the current message and goes on to 

the next one 
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Ctrl-d 



(EOF) Puts unexamined mail back in the mailbox 
and stops 



mluser ...] Sends a copy of the current message to the 
specified users 

p Displays a message again 

q Puts mail back in the mailbox and quits 

s [file ...] Saves the message in the named file(s) 

w [file ...] Saves the message, without a header, in the 
named file(s) 

X Exits, without changing the mailbox file 

Goes back to previous message 

+ Goes to next message. After last message, 

returns you to system prompt. 

Icommand Escapes to the shell and executes the spe- 

cified command 

? Displays a sunmiary of what you can enter 

at the "?" prompt 



Examples 



This command sends the message "This is a message sent to 
Chris, w endy, and ric" to chris, wendy, and ric. Press 
MtfjUW. then ■wiiBiw . to send a message. 



miail chris wendy ric |2§QQ| 
This Js a message sent to chris, wendy, and 
ric. 



Retn 
CtrOT 



This command prints your mail on your system's printer, 
mail -p Brfdilill 



2 



MAIL(C) 



MAIL(C) 



Files 

/usr/spool/mail/* 
/etc/passwd 
mbox 
/tmp/ma* 
dead, letter 



Mailboxes 

Identifies senders and recipients 
Saved mail 
Tempfile 
Unmailable text 
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Name 



mail - Sends, reads, or disposes of mail. 



Syntax 



mail 



maU 



[[ -u user] [-b bcclist] [-c cclist] [-r rrlist] 
[-f mailbox]] [-d] [-e] [-R] [-1] [user ...] 
[-S subject] [-i] [user ...] 



Description 



Mail (/usr /bin/mail) is a mail processing system that 
supports composing of messages, and sending and receiving 
of mail between multipe users. When sending mail, a user 
is the name of a user or of an alias assigned to a machine 
or to a group of users. 



Options include: 



-u user 

-h bcclist 
-c cclist 
-r rrlist 



-f mailbox 

-d 

-e 



Tells mail to read the system mailbox 
belonging to the specified user. 



When sending mail, initialize the bcc 
(before carbon copy), cc (carbon copy), or 
rr (return receipt) fields in the message 
header to the following list of users. 
These fields may be subsequently added to 
or edited through the use of 'bee, 'cc, 
"rrt, and "header commands in compose 
mode. Only the last occurrence of each 
flag is used. 

Tells maU to read the specified mailbox 
instead of the default user's system mail- 
box. 

Prints debugging information. 

Allows escapes from compose mode when 
input comes from a file. 
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-R Makes the mail session "read-only" by pre- 

venting alteration of the mailbox being 
read. Useful when accessing system-wide 
mailboxes. 

-i Tells mail to ignore interrupts sent from 

the terminal. This is useful when reading 
or sending mail over telephone lines where 
"noise" may produce unwanted interrupts. 

-s subject Specifies subject as the text of the 

Subject: field for the message being sent. 



Sending Mail 

To send a message to one or more other people, invoke mail 
with arguments which are the names of peole to send to. 
Y ou are th en expected to type in your message, followed by 
a ■wneiB at the beginning of a line. 



Reading Mail 

To read mail, invoke mail with no arguments. This will 
check your mail out of the system-wide directory so that 
you can read and dispose of the messages sent to you. A 
message header is printed out for each message in your 
mailbox. The current message is initially the last num- 
bered message and can be printed using the print command 
(which can be abbreviated p). You can move among the 
messages much as you move between lines in ed(C), with 
the + and - commands moving backwards and forwards, and 
simple numbers typing the addressed message. 

If new mail arrives during the mail session you can read 
in the new messages with the restart command. 



Disposing of Mail 

After examining a message you can delete(d) the message 
or reply(r) to it. Deletion causes the mail program to 
forget about the message. This is not irreversible; the 
message can be undeleted(u) by giving its number, or the 
mail session can be aborted by giving the exit(x) command. 
Usually, though, deleted messages will disappear com- 
pletely. 
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Specifying Messages 

Commands such as print and delete often can be given a 
list of message numbers as arguments to apply to a number 
of messages at once. Thus, delete 1 2 deletes messages 1 
and 2, while delete 1-5 deletes messages 1 through 5. The 
special name * addresses all messages, and $ addresses the 
last message; thus, the top command, which prints the 
first few lines of a message, could be used in top * to 
print the first few lines of all messages. 



Replying To or Originating Mail 

You can use the reply command to set up a response to a 
message, sending it back to the person who se nt it. T hen 
you can type the text of the reply, and press mnmm to 
send it. While you are composing a message, mail treats 
lines beginning with a tilde (~) as special. For in- 
stance, typing "m (alone on a line) places a copy of the 
current message into the response, shifting it right by 
one tabstop. Other escapes set up subject fields, add and 
delete recipients to the message, and allow you to escape 
either to an editor to revise the message or to a shell to 
run some commands. (These options are summarized later.) 



Ending a Mail Session 

You can end a mail session with the quit(q) command. Mes- 
sages that have been examined go to your mbox file unless 
they have been deleted. Unexamined messages go back to 
the post office. The -f option causes mail to read in the 
contents of your mbox (or the specified file) for proces- 
sing; when you quit, mail writes undeleted messages back 
to this file. The -i option causes mail to ignore inter- 
rupts. 



Using Aliases and Distribution Lists 

It is also possible to create a personal distribution 
list. For instance, you can send mail to "cohorts" and 
have it go to a group of people. Such lists can be de- 
fined by typing a line like: 

alias cohorts bill bob barry bobo betty beth bobbi 
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in the .mailrc file of your home directory. The current 
list of such aliases can be displayed by the alias(a) com- 
mand in mail. System-wide distribution lists can be 
created by editing /usr/lib/mail/aliases; see allases(M); 
these are kept in a slightly different syntax. In mail 
that you send, personal aliases will be expanded in mail 
sent to others so that they will be able to reply to the 
recipients. System-wide aliases are not expanded when the 
mail is sent, but any reply returned to the machine will 
have the system-wide alias expanded. 

Mail has a number of options that can be set in the 
.mailrc file to alter its behavior; thus, set askcc en- 
ables the "askcc" feature. (These options are summarized 
below. ) 



Summary 



Each mail command is typed on a line by itself, and may 
take arguments following the command word. The command 
need not be typed in its entirety - the first command 
which matches the typed prefix is used. For the commands 
that take message lists as arguments, if no message list 
is given, then the next message forward that satisfies the 
command's requirements is used. If there are no messages 
forward of the current message, the search proceeds back- 
wards, and if there are no messages at all, mail displays 
"No applicable messages" and aborts the command. 



[n] 



Goes to the previous message and prints 
it out. If given a numeric argument, n, 
goes to the nth previous message and prints 
it. 



+ [n] 



Icommand 



Goes to the next message and prints it out. 
If given a numeric argument, n, goes to the 
nth next message and prints it. 

Goes to the next message and prints it out. 

Prints a brief summary of commands. 

Executes the shell command which follows. 

Prints out the current message number. 
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Prints out the first message. 

$ Prints out the last message. 

alias (a) With no arguments, prints out all currently- 

defined aliases. With one argument, prints 
out that alias. With more than one argu- 
ment, adds the users named in the second 
and later arguments to the alias named in 
the first argument. 

Alias useTS Prints system-wide list of aliases for 

users. At least one user must be speci- 
fied. 

Changes the user's working directory to 
that specified. If no directory is given, 
it changes to the user's login directory. 

Takes a list of messages as an argument anc 
marks them all as deleted. Deleted mes- 
sages are not retained in the system mail- 
box after a quit, nor are they available to 
any command other than the undelete com- 
mand. 

Deletes the current message and prints the 
next message. If there is no next message, 
mail says "no more messages." 

Expands shell metacharacters. 

Takes a list of messages and invokes the 
text editor on each one in turn. Upon re- 
turning from the editor, the message is 
read back in. 

Effects an immediate return to the shell 
without modifying the user's system mail- 
box, mbox file, or edit file in -f. 

Prints the name of the file mail is 
reading. If it is a mailbox, the name of 
the owner is returned. 

forward (f) Forwards the current message to the named 
users. The current message is indented 
within the forwarded message. 



cd (c) 
delete (d) 

dp 

echo Path 
edit (e) 

exit (x) 
file (fi) 
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Forward (F) Forwards the current message to the named 
users. The current message is not indented 
within the forwarded message. 

headers (h) Lists the current range of headers, which 
is an 18 message group. If a + argument 
is given, then the next 18 message group is 
printed, and if a - argument is given, the 
previous 18 message group is printed. Both 
+ and - may take a number to view a par- 
ticular window. If a message-list is given, 
it prints the specified headers. 



hold (ho) Takes a message list and marks each message 

to be saved in the user's system mailbox 
instead of in mbox. Use only when the 
autombox switch is set. Does not override 
the delete command. 



Ust 



Prints a list of mail commands. 



Ipr (1) Prints out each message in a message-list 

on the lineprinter. 

mail (m) Takes as argument login names and 

distribution group names and sends mail to 
those people. 

mbox (mb) Marks messages in a message list so that 
they are saved in the user mailbox after 
leaving mail. 

move mesg-list mesg-num 

Places the messages specified in mesg-list 
after the message specified in mesg-num. 
If mesg-num is 0, mesg-list moves to the 
top of the mailbox. 

next (n) Goes to the next message in sequence and 

prints it. With an argument list, next 
types t he next matching message (like + or 



print (p) Prints out each message in a message-list 

on the terminal display. 
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quit (q) Terminates the session, retaining all 

undeleted, unsaved messages in the system 
mailbox and removing all other messages. 
Files marked with a star (*) are saved; 
files marked with an "M" are saved in the 
user mailbox. If new mail has arrived dur- 
ing the session, the message "You have new 
mail" is given. If quit is given while 
editing a mailbox file with the -f flag, 
then the edit file is rewritten. You then 
return to the shell, unless the rewrite of 
the edit file fails, in which case you can 
escape with the exit command. 

reply (r) Takes a message list and sends mail to each 

message author. The default message must 
not be deleted. 

Reply (R) Takes a message list and sends mail to each 

message author and each member of the mes- 
sage just like the mail command. The de- 
fault message must not be deleted. 

restart Reads in messages that arrived during the 

current mail session. 



save (s) Takes a message list and a filename and 

appends each message in turn to the end of 
the file. The filename, in quotation 
marks, followed by the line count and char- 
acter count is echoed on the user's termi- 
nal. 



set (se) With no arguments, prints all variable 

values. Otherwise, sets an option. Argu- 
ments are of the form optwn=value or op- 
tion. 



shell (sh) Invokes an interactive version of the 

shell. 

size (si) Takes a message list and prints out the 

size in characters of each message. 



source (so) file 

Reads mail commands from the file given as 
its only argument. 
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string string mesg-list 

Searches for string in mesg-list. If no 
mesg-list is specified, all undeleted mes- 
sages are searched. Case is ignored in the 
. search. 

top (t) Takes a message list and prints the top few 

lines of each. The number of lines printed 
is controlled by the toplines variable and 
defaults to six. 

undelete (u) Takes a message list and marks each one as 
not being deleted. 

unset (uns) Takes a list of option names and discards 
their remembered values; the inverse of 
set. 

Takes a message list and invokes vi on each 
message. 

Looks up a list of target mail recipients 
and prints the real names or descriptions 
of each recipient. If the first character 
of the first argument is alphabetic, the 
arguments are looked up without change. 
Otherwise, the arguments are assumed to be 
a message list. For each message in the 
list, the "From" person is extracted from 
the header and added to list of users to be 
searched. 

If a target mail recipient contains a 
machine and user name, nothing is printed. 
If it is a private alias, "private alias" 
is printed. If it is a global alias, the 
name or description of the recipient is 
printed (contents of the $n field in the 
alias file). If all of the above fail, the 
user is looked up in /etc/passwd; if the 
user is a local user, "local user" is 
printed. Finally, if none of the above 
tests and searches succeed, "unknown" is 
printed. 

write (w) filename 

Saves the body of the message in the named 
file. 
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Here is a summary of the compose escapes, which are used 
when composing messages to perform special functions. 
Compose escapes are only recognized at the beginning of 
lines. 

string Inserts the string of text in the message 

prefaced by a single tilde {"). If you 
have changed the ESCAPE character, then 
you should double that character instead. 

~? Prints out help for compose escapes. 

Same as ■wnw on a new line. 

~lcmd Executes the indicated shell command, then 

returns to the message. 

~\cmd Pipes the message through the command as 

a filter. If the command gives no output 
or terminates abnormally, retains the orig- 
inal text of the message. 



mail-command 



zmail-command 



Executes a mail coromand, then returns to 
compose mode. 



Executes a mail conmiand, then returns to 
compose mode. 



'alias Prints list of private aliases, 

"alias aliasname 

Prints names included in private aliasname. 

"Alias Performs aliasing by first examining pri- 

vate aliases and then system-wide aliases 
using all three global alias files 
(aliases.hash, f aliases, and mailiases). 
Only the final result is printed (non-local 
mail recipients will have the complete de- 
livery path printed). The user list is 
taken from header fields. 
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"Alias users Performs aliasing by first examining 
private aliases and then system-wide 
aliases using all three global alias files 
(aliases. hash, f aliases, and mailiases). 
Only the final result is printed (non-local 
mail recipients will have the complete de- 
livery path printed). At least one user 
must be specified. 

"b name... Adds the given names to the list of blind 
carbon copy recipients. 

"c name... Adds the given names to the list of carbon 
copy recipients. 



"cc name. 

'd 



~h 



Same as 'c. 

Reads the dead, letter file from your home 
directory into the message. 

Invokes the text editor on the message col- 
lected so far. After the editing session 
is finished, you may continue appending 
text to the message. 

Edits the message header fields by t57ping 
each one in turn and allowing the user to 
append text to the end or modify the field 
with the current terminal ERASE and KILL 
characters. 



'm mesg-list Reads the named messages into the message 
buffer;, shifted right one TAB. If no mes- 
sages are specified, reads the current mes- 
sage. 

'M mesg-list Reads the named messages into the message 
buffer, shifted right one TAB. If no mes- 
sages are specified, reads the current mes- 
sage. 

'p Prints out the messages collected so far, 

prefaced by the message header fields. 



'Print 



Prints the real names or descriptions (in 
parentheses) after each recipient in a 
header field. 
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q Aborts the message being sent, copying the 

message to the dead, letter file in your 
home directory if save is set. 

r filename Reads the named file into the message 
buffer. 



"Return name Adds the given names to the Return-receipt- 
to field. 



s string Causes the named string to become the 

current subject field. 

't name... Adds the given names to the direct 
recipient list. 



'w filename 



Invokes a visual editor (defined by the 
VISUAL option) on the message buffer. 
After you quit the editor, you may resume 
appending text to the end of your message. 

Writes the body of the message to the 
named file. 



Options are controlled with the set and unset commands. 
An option may be either a switch, in which case it is 
either on or off, or a string, in which case the actual 
value is of interest. The switch options include the fol- 
lowing: 



askcc Causes you to be prompted for additional 

carbon copy recipients at the end of each 
message. Responding with a newline indi- 
cates your satisfaction with the current 
list. 



asksubject Causes mail to prompt you for the subject 
of each message you send. If you respond 
with simply a newline, no subject field is 
sent. 



autombox Causes all examined messages to be saved ir 

the user mailbox unless deleted or saved, 
autoprint Causes the delete command to be- 
have like dp - thus, after deleting a mes- 
sage, the next one will be tjTped auto- 
matically. 
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chron 
dot 
ignore 
mchron 

metoo 



Causes messages to be displayed in chrono- 
logical order. 

Permits use of dot (.) as the end-of-file 
character when composing messages. 

Causes interrupt signals from your terminal 
to be ignored and echoed as at-signs (@). 

Causes messages to be listed in numerical 
order (most recently received first), but 
displayed in chronological order. 

Usually, when a group is expanded that con- 
tains the sender, the sender is removed 
from the expansion. Setting this option 
causes the sender to be included in the 
group. 



nosave Prevents aborted messages from being ap- 

pended to the dead, letter file in your home 
directory on receipt of two interrupts (or 
a ~q). 

/ quiet Suppresses the printing of the version 

header when first invoked. 



verify Causes each target mail recipient to be 

verified. This option permits errors made 
while composing messages to be corrected or 
ignored. 



The following options have string values: 



EDITOR Pathname of the text editor to use in the 

edit command and ~e escape. If not de- 
fined, then a default editor is used. 

SHELL Pathname of the shell to use in the ! com- 

mand and the ~l escape. A default shell 
is used if this option is not defined. 

VISUAL Pathname the text editor to use in the 

visual command and ~v escape. 



12 



MAIL(C) 



MAIL(C) 



escape 



page=n 



record 



toplines 



If defined, the first character of this 
option gives the character to use in the 
place of the tilde (~) to denotes escapes. 

Specifies the number of lines (n) to be 
printed in a "page" of text when displaying 
messages. 

If defined, gives the pathname of the file 
used to record all outgoing mail. If not 
defined, then outgoing mail is not saved. 

If defined, gives the number of lines of a 
message to be printed out with the top 
command; normally, the first six lines are 
printed. 



Files 



/usr/spool/mail/* 
/usr/name/dead. letter 

/usr/name/mbox 
/usr/name/.mailrc 

/usr/lib/mail/aliases 
/usr /lib/mail/aliases, hash 
/usr/lib/mail/faliases 

/usr/lib/mail/mailiases 
/usr /lib/mailhelp. cmd 
/usr/lib/mailhelp. esc 
/usr/lib/mailhelp. set 
/usr/lib/mail/mailrc 
/usr/bin/mail 



System mailboxes 
File where undeliverable mail 
is deposited. 
Your old mail 

File giving initial mail com- 
mands 

System-wide aliases 
System-wide alias database 
Forwarding aliases for the 
local machine 
Machine aliases 
Help file 
Help file 
Help file 

System initialization file 
The mail command 



See Also 

aliases(M), aliashash(M), netutil(C) 
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Notes 

This utility was developed at the University of California 
at Berkeley and is used with permission. 

k 

If you use the C-shell to send mail, be sure to escape any 
exclamation point (!) used on the command line. 
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Name 

make - Maintains, updates, and regenerates groups of pro- 
grams. 



Sjmitax 

make [-f makeftte] [-p] [-i] [-k] [-s] [-r] [-n] [-b] [-e] 
[-U] [-t] [-q] [names] 



Description 

The make coimnand allows the programmer to maintain, up- 
date, and regenerate groups of computer programs. The 
following is a brief description of all options and some 
special names: 

-f makefile 

Description file name. Makefile is assumed to be the 
name of a description file. 

-p Print out the complete set of macro definitions and 
target descriptions. 

-i Ignore error codes returned by invoked commands. 

This mode is entered if the fake target name .IGNORE 
appears in the description file. 

-k Abandon work on the current entry if it fails, but 

continue on other branches that do not depend on that 
entry. 

-s Silent mode. Do not print command lines before exe- 
cuting. This mode is also entered if the fake target 
name .SILENT appears in the description file. 

-r Do not use the built-in rules. 

-n No execute mode. Print commands, but do not execut( 
them. Even lines beginning with an @ are printed. 

-b Compatibility mode for old makefiles. 
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-e Environment variables override assignments within 
makefiles. 

-u Force an unconditional update. 

-t Touch the target files (causing them to be 

up-to-date) rather than issue the usual commands. 

-q Question. The make conmiand returns a zero or 

non-zero status code depending on whether the target 
file is or is not up-to-date. 

.DEFAULT 

If a file must be made but there are no explicit 
commands or relevant built-in rules, the commands 
associated with the name .DEFAULT are used if it 
exists. 

•PRECIOUS 

Dependents of this target will not be removed when 
quit or interrupt are hit. 

.SILENT 

Same effect as the -s option. 

.IGNORE 

Same effect as the -i option. 

Make executes conmiands in makefile to update one or more 
target names. Name is typically a program. If no -f op- 
tion is present, makefile. Makefile, and the Source Code 
Control System (SCCS) files s.makefile, and s.Makefile are 
tried in order. If makefile is the standard input is 
taken. More than one -f makefile argument pair may ap- 
pear. 

Make updates a target only if its dependents are newer 
than the target (unless the -u option is used to force an 
unconditional update). All prerequisite files of a target 
are added recursively to the list of targets. Missing 
files are deemed to be out-of-date. 

Makefile contains a sequence of entries that specify de- 
pendencies. The first line of an entry is a 
blank-separated, non-null list of targets, then a :, then 
a (possibly null) list of prerequisite files or dependen- 
cies. Text following a ; and all following lines that 
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begin with a tab are shell commands to be executed to up- 
date the target. The first non-empty line that does not 
begin with a tab or # begins a new dependency or macro 
definition. Shell commands may be continued across lines 
with the <backslash> <new-line> sequence. Everything 
printed by make (except the initial tab) is passed direct- 
ly to the shell as is. Thus, 

echo a\ 
b 

will produce: 

ab 

exactly the same as the shell would. 

Sharp (#) and new-line surround comments. 

The following makefile says that pgm depends on two files 
a.o and b.o, and that they in turn depend on their corres- 
ponding source files (a.c and b.c) and a common file 
incl.h: 

pgm : a . o b . o 

cc a.o b.o -o pgm 

a. o: incl.h a.c 

cc -c a.c 

b. o: incl.h b.c 

cc -c b.c 

Conmiand lines are executed one at a time, each by its own 
shell. The SHELL environment variable can be used to 
specify which shell make should use to execute conmiands. 
The default is /bin/sh. The first one or two characters 
in a command can be the following: -, @, -@, or @-. If @ 
is present, printing of the command is suppressed. If - 
is present, make ignores an error. A line is printed when 
it is executed unless the -s option is present, or the 
entry .SILENT: is in makefile, or unless the initial charac- 
ter sequence contains a @. The -n option specifies print- 
ing without execution; however, if the command line has 
the string $(MAKE) in it, the line is always executed (see 
discussion of the MAKEFLAGS macro under "Environment"). 
The -t (touch) option updates the modified date of a file 
without executing any commands. 
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Commands returning non-zero status normally terminate 
make. If the -i option is present, or the entry .IGNORE: 
appears in makefile, or the initial character sequence of 
the command contains -. the error is ignored. If the -k 
option is present, work is abandoned on the current entry, 
but continues on other branches that do not depend on that 
entry. 

The -b option allows old makefiles (those written for the 
old version of make) to run without errors. 

Interrupt and quit cause the target to be deleted unless 
the target is a dependent of the special name .PRECIOUS. 



Environment 

The environment is read by make. All variables are as- 
sumed to be macro definitions and processed as such. The 
environment variables are processed before any makefile 
and after the internal rules; thus, macro assignments in a 
makefile override environment variables. The -e option 
causes the environment to override the macro assignments 
, in a makefile. Suffixes and their associated rules in the 

) makefile will override any identical suffixes in the 

built-in rules. 

The MAKEFLAGS environment variable is processed by make 
as containing any legal input option (except -f and -p) 
defined for the command line. Further, upon invocation, 
make "invents" the variable if it is not in the environ- 
ment, puts the current options into it, and passes it on 
to invocations of commands. Thus, MAKEFLAGS always 
contains the current input options. This proves very use- 
ful for "super-makes". In fact, as noted above, when the 
-n option is used, the command $(MAKE) is executed any- 
way; hence, one can perform a make -n recursively on a 
whole software system to see what would have been exe- 
cuted. This is because the -n is put in MAKEFLAGS and 
passed to further invocations of $(MAKE). This is one way 
of debugging all of the makefiles for a software project 
without actually doing anything. 

) 
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Include Files 

If the string include appears as the first seven letters 
of a line in a makefile, and is followed by a blank or a 
tab, the rest of the line is assumed to be a file name and 
will be read by the current invocation, after substituting 
for any macros. 



Macros 

Entries of the form stringl = string2 are macro defini- 
tions. string2 is defined as all characters up to a com- 
ment character or an unescaped new-line. Subsequent ap- 
pearances of ${stringl[:substl=[subst2]]) are replaced by 
string2. The parentheses are optional if a single charac- 
ter macro name is used and there is no substitute se- 
quence. The optional :substl=subst2 is a substitute se- 
quence. If it is specified, all non-overlapping occur- 
rences of substl in the named macro are replaced by 
subst2. Strings (for the purposes of this type of 
substitution) are delimited by blanks, tabs, new-line 
characters, and beginnings of lines. An example of the 
use of the substitute sequence is shown under "Libraries." 



Internal Macros 

There are five internally maintained macros which are use- 
ful for writing rules for building targets. 

$* The macro $* stands for the file name part of the 
current dependent with the suffix deleted. It is 
evaluated only for inference rules. 

$@ The $@ macro stands for the full target name of the 
current target. It is evaluated only for explicitly 
named dependencies. 

$< The $< macro is only evaluated for inference rules or 
the .DEFAULT rule. It is the module which is 
out-of-date with respect to the target (i.e., the 
"manufactured" dependent file name). Thus, in the 
.CO rule, the $< macro would evaluate to the .e 
file. An example for making optimized .o files from 
.c files is: 
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. c. o: 

cc -c -0 $*.c 



cc -c -0 $< 



$? The $? macro is evaluated when explicit rules from 
the makefile are evaluated. It is the list of pre- 
requisites that are out-of-date with respect to the 
target; essentially, those modules which must be re- 
built. 

$% The $% macro is only evaluated when the target is an 
archive library member of the form lib(file.o). In 
this case, $ evaluates to lib and $% evaluates to the 
library member, file.o. 

Four of the five macros can have alternative forms. When 
an upper case D or F is appended to any of the four 
macros, the meaning is changed to "directory part" for D 
and "file part" for F. Thus, $(@D) refers to the direc- 
tory part of the string $@. If there is no directory 
part, ./ is generated. The only macro excluded from this 
alternative form is $?. 



Suffixes 

Certain names (for instance, those ending with .o) have 
inferable prerequisites such as .c, .s, etc. If no update 
commands for such a file appear in makefile^ and if an 
inferable prerequisite exists, that prerequisite is com- 
piled to make the target. In this case, make has infer- 
ence rules which allow building files from other files by 
examining the suffixes and determining an appropriate in- 
ference rule to use. The current default inference rules 
are; 

.c .c~ .f .f~ .sh .sh~ 

.CO .c.a .c~.o .c~.c .c~.a 

.f.o .f.a .f~.o .f-.f .f-.a 

.h~.h .s.o .s~.o .s~.s .s~.a .sh^.sh 

.1.0 .i.c .r.o .r.i .r.c 

.y.o .y.c .y~.o .y~.y .y~.c 
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The internal rules for make are contained in the source 
file rules, c for the make program. These rules can be 
locally modified. To print out the rules compiled into 
the make on any machine in a form suitable for recompila- 
tion, the following command is used: 

make -fp - 2>/dev/null </dev/null 

A tilde in the above rules refers to an SCCS file (see 
sccsfile(F)). Thus, the rule .c'.o would transform an 
SCCS C source file into an object file (.o). Because 
the s. of the SCCS files is a prefix, it is incompat- 
ible with make's suffix point of view. Hence, the tilde 
is a way of changing any file reference into an SCCS 
file reference. 

A rule with only one suffix (i.e., .c:) is the definition 
of how to build x from x.c. In effect, the other suffix 
is null. This is useful for building targets from only 
one source file (e.g., shell procedures, simple C 
programs). 

Additional suffixes are given as the dependency list for 
.SUFFIXES. Order is significant; the first possible 
name for which both a file and a rule exist is inferred as 
a prerequisite. The default list is: 

.SUFFIXES: .o .c .c~ .y .y~ .1 A" .s .s~ .sh .sh~ .h 
.h- .f .f~ 

Here again, the above command for printing the internal 
rules will display the list of suffixes implemented on the 
current machine. Multiple suffix lists accumulate; 
.SUFFIXES: with no dependencies clears the list of suf- 
fixes. 



Inference Rules 

The first example can be done more briefly. 

pgm : a . o b . o 

cc a.o b.o -o pgm 
a.o b.o: incl.h 
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This is because make has a set of internal rules for 
building files. The user may add rules to this list by 
simply putting them in the makefile. 

. Certain macros are used by the default inference rules to 

; permit the inclusion of optional matter in any resulting 

commands. For example, CFLAGS, LFLAGS, and YFLAGS 
are used for compiler options to cc(CP), lex(CP), and 
yacc(CP), respectively. Again, the previous method for 
examining the current rules is reconmiended. 

The inference of prerequisites can be controlled. The 
rule to create a file with suffix .o from a file with suf- 
fix .0 is specified as an entry with .c.o: as the target 
and no dependents. Shell commands associated with the 
target define the rule for making a .o file from a .c 
file. Any target that has no slashes in it and starts 
with a dot is identified as a rule and not a true target. 



Libraries 

If a target or dependency name contains parentheses, it is 
assumed to be an archive library, the string within paren- 
theses referring to a member within the library. Thus 
lib(file.o) and $(LIB)(file.o) both refer to an archive 
library which contains file.o. (This assumes the LIB 
macro has been previously defined.) The expression 
$(LIB)(filel.o file2.o) is not legal. Rules pertaining to 
archive libraries have the form .XX. a where the XX is the 
suffix from which the archive member is to be made. An 
unfortunate byproduct of the current implementation re- 
quires the XX to be different from the suffix of the ar- 
chive member. Thus, one cannot have lib(file.o) depend 
upon file.o explicitly. The most common use of the ar- 
chive interface follows. Here, we assume the source files 
are all C t57pe source: 

lib: lib(filel.o) lib(file2.o) lib(file3.o) 
Secho lib is now up-to-date 

. c. a: 

$(CC) -c $(CFLAGS) $< 

$(AR) $(ARFLAGS) $§ $*.o 
rm -f $*.o 
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In fact, the .c.a rule listed above is built into make and 
is unnecessary in this example. A more interesting, but 
more limited example of an archive library maintenance 
construction follows; 

lib: lib(filel.o) lib(file2.o) lib(file3.o) 
$(CC) -c $(CFLAGS) $(?:.o=.c) 
$(AR) $(ARFLAGS) lib $? 
rm $? 8echo lib is now up-to-date 

.c.a:; 

Here the substitution mode of the macro expansions is 
used. The $? list is defined to be the set of object 
file names (inside lib) whose C source files are 
out-of-date. The substitution mode translates the .o to 
.c. (Unfortunately, one cannot as yet transform to .c~; 
however, this may become possible in the future. ) Note 
also, the disabling of the .c.a: rule, which would have 
created each object file, one by one. This particular 
construct speeds up archive library maintenance consider- 
ably. This type of construct becomes very cumbersome if 
the archive library contains a mix of assembly programs 
and C programs. 



Files 

[Mmlakefile and s. [Mmjakef ile /bin/sh 



See Also 

cd(C), sh(C), and cc(CP), lex(CP), yacc(CP), printf(S), 
sccsfile(F) in the Reference (CP, S, F) 



Notes 

Some commands return non-zero status inappropriately; use 
-i to overcome the difficulty. 

File names with the characters = : @ will not work. Com- 
mands that are directly executed by the shell, notably 
cd(C), are ineffectual across newlines in make. The syn- 
tax (lib(filel.o file2.o fileS.o) is illegal. You cannot 
build lib(file.o) from file.o. The macro $(a:.o=.c~) does 
not work. Named pipes are not handled well. 
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Name 

mesg - Allows or disallows messages sent to a terminal. 

y Syntax 

mesg [ -n ] [ -y ] 

Description 

Mesg allows or disallows messages sent to a terminal and 
reports the current state without changing it. The argu- 
ments are: 

-n Forbids messages via write (C) by revoking non-user 
write permission on the user's terminal. 

-y Reinstates write permission. 

Files 
) /dev/tty* 

See Also 

write (C) 

Diagnostics 

The exit status is 0 if messages are receivable, 1 if they 
are not, 2 if there is an error. 
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Name 

mkdir - Makes a new directory. 



Syntax 

mkdir [ -m mode ] [ -p ] dirname ... 



Description 

The mkdir command creates a new directory. The standard 
entries "dot" (.), for the directory itself, and "dot dot" 
(..), for its parent, are made automatically. 

A directory name can be up to 14 characters long. Do not 
use spaces or any of the following characters in the name: 

* ? [ . 

I ] 
( \ 
: ) 

You can create several directories at one time by separat- 
ing the directory names with spaces. 

To use the mkdir command, you must have write permission 
in the current directory. 

The owner ID and group ID of the new directories are set 
to the process's real user ID and group ID, respectively. 



Options 

The following options apply to mkdir: 

-m Specifies the mode to be used for new directories. 
(See chmod(C) for tj^pes of modes.) The default is 
777, modified by the umask value. 

-p Creates dirname by creating all the non-existing 
parent directories first. 
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Examples 

This command creates directories called Accounting, En- 
gineering, and Marketing in the current directory. 

J mkdir Accounting Engineering Marketing B^/JM 

To create the subdirectory structure Itr/jd/scott, type: 
mkdir -p Itr/jd/scott 

See Also 

chmod(C), rmdir(C), umask(C) 

Diagnostics 

Mkdir returns exit code 0 if all directories given in the 
command line were made successfully. Otherwise, it prints 
a diagnostic and returns non-zero. 

) 
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Name 

mknod - Builds a special file. 



Syntax 

/etc/mknod name [b] | [c] major minor 
/etc/mknod name m 
/etc/mknod name p 
/etc/mknod name s 



Description 

This command can only be used by the super user. 

Mknod makes a directory entry and corresponding i-node for 
a special file. The first argument is the name of the 
file. The second argument is b if the special file is 
block-type (disks, tape) or c if it is character- type 
(other devices). The last two arguments are numbers spe- 
cifying the major device type and the minor device (for 
example, unit, drive, or line number). They may be either 
decimal or octal. 

The assignment of major device numbers is specific to each 
system. These numbers come from the system source file 
master. 



Options 

m Creates named shared data (memory) 

p Creates named pipes 

s Creates semaphores 



Examples 



The following command creates a block-type device named 
hdOd on major device number 0, minor device number 4. 

/etc/mknod hdOd b 0 4 K^SI 
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The next command creates a character device named tty03 on 
major device 10, tty number 3. 

/etc/mknod /dev/tty03 c 10 3 



See Also 

mknod(S) in the Reference (CP, S, F) 



Notes 

If mknod is used to create a device in a remote directory 
(RFS), the major and minor device numbers are interpreted 
by the server. 
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Name 

mkstr - Creates an error message file from C source. 



Synt£ix 

mkstr [-] messagefile prefix file ... 



Description 

Mkstr is used to create files of error messages. Its use 
can make programs with large numbers of error diagnostics 
much smaller, and reduce system overhead in running the 
program as the error messages do not have to be constantly 
swapped in and out. 

Mkstr will process each specified /ile, by placing a modi- 
fied version of the input file in a file whose name con- 
sists of the specified prefix and the original name. The 
optional dash (-) causes the error messages to be placed 
at the end of the specified message file for recompiling 
part of a large mkstr program. 

A typical mkstr command line is: 

mkstr pistrings xx *.c 

This command causes all the error messages from the C 
source files in the current directory to be placed in the 
file pistrings and processed copies of the source for 
these files to be placed in files whose names are prefixed 
with XX. 

To process the error messages in the source to the message 
file, mkstr keys on the string 'errorC" in the input 
stream. Each time it occurs, the C string starting at the 
is placed in the message file followed by a null char- 
acter and a newline character; the null character termi- 
nates the message so it can be easily used when retrieved, 
the newline character makes it possible to sensibly cat(C) 
the error message file to see its contents. The massaged 
copy of the input file then contains an Iseek(S) pointer 
into the file which can be used to retrieve the message. 
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For example, the command changes the following: 

error ("Error on reading", a2, a3, a4); 

i into: 

error(m, a2, a3, a4) ; 

where m is the seek position of the string in the result- 
ing error message file. The programmer must create a rou- 
tine error which opens the message file, reads the string, 
and prints it out. The following example illustrates such 
a routine. 



Example 



char efilname[] = "/usr/lib/pi_strings" ; 
int efil = -1: 

error (al, a2, a3, a4 ) 
{ 

char buf [256] ; 

if (efil < 0) { 

efil = open(ef ilname, 0); 
if (efil < 0) { 

oops : 

perror(ef ilname) ; 
exit(C) ; 



if (lseek(efil, (long) al, 0) || read{efil, 
buf, 256) <= 0) 
goto oops; 
printf(buf, a2, aS, a4) ; 



See Also 

Iseek(S), xstr(CP) 
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Credit 



This utility was developed at the University of California 
at Berkeley and is used with permission. 
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Name 

more - Views a file one screen at a time. 
SjTntax 

more -[cdflrsuw] [-n] [+linenuTnber] [+/pattern] [file ...] 



Description 

Using the more command, you can examine continuous text 
one screen at a time. More pauses at the end of each 
screen, printing: 

~More~ 

If you type BrfAJiB at the "— More—" mess age, one more line 
is displayed. If you press the BSBBWSSBHi . another full 
screen of the text is displayed. 

If more is reading from a file, rather than a pipe, the 
"—More—" message also contains a percentage telling you 
the amount you have read so far. 

More looks in the environment variable MORE to preset any 
flags desired. For example, if you prefer to view files 
using the -c option, the shell command MORE=-c in the 
.profile file causes all invocations of more to use this 
mode. 



Options 

-c Redraws each full screenful of text from 

the top of the screen instead of scrolling. 
When you use -c, the -n option is ignored. 
The -c option is ignored if the terminal 
does not have the ability to clear to the 
end of the line. 

-d Displays the message "Hit space to con- 

tinue, Del to abort" at the end of each 
screen. This is useful if more is being 
used as a filter. 
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-f 



Causes more to count logical, rather than 
screen lines. That is, long lines are not 
folded. 



-I 



-r 



Causes more to igno re form feed control 
characters (QQSQI). If this option is not 
given, more paus es after any line that con- 
tains a ■•iiBHW . as if the end of a screen 
had been reached. Also, if a file begins 
with a form feed, the screen is cleared 
before the file is printed. 



Causes any control characters that more 
does n ot recogn ize to be displayed as *x, 
where laHlirai is the unrecognized control 
character. 



-s 



-u 
-w 



Removes multiple blank lines from the out- 
put. This is especially helpful when view- 
ing nroff output, maximizing the useful 
information present on the screen. 

Suppresses underlining in the source file. 

Causes more to prompt you with the mes- 
sage: 



"--No more--" 

and wait for you to press any key before 
exiting. Without this option, you auto- 
matically exit to system level at the end 
of the file. 

-n Displays n lines in the specified file. 

+linenumber Starts the file display at the specified 
line number. 

+ /pattern Starts the file display two lines before 

the line containing the pattern. 

There are several responses you can use when more pauses 
at the "--More--" prompt . With the exception of i/expr, 
you don't need to press Bt^BW after these options. 
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Ctrl-d 



Space 



Displays 11 more lines. If you specify the 
i option, scroll size is changed from 11 to 
what you specify. 



d Same as 



Ctrl-d 



:f Displays the current file name and line 

number. 

h or ? Describes all the more commands. 



Displays i more lines, or another screenful 
if no argument is given. 



i/expr Searches for the I'th occurrence of the 

regular expression expr. If there are less 
than i occurrences of expr, and the input 
is a file rather than a pipe, the position 
in the file remains unchanged. Otherwise, 
a screenful is displayed, starting two 
lines before the place where the expression 
was found. The user's erase and kill char- 
acters may be used to edit the regular ex- 
pression. Erasing back past the first 
column cancels the search command. 

if Skips i screenfuls and prints a screen full 

of lines. 

i:n Skips to the ith next file given in the 

command line (skips to the last file if i 
doesn't make sense). 

hp Skips to the ith previous file given in the 

command line. If in the middle of printing 
out a file, more goes back to the beginning 
of the file. If i doesn't make sense, more 
skips back to the first file. 

If more is not reading from a file, the 
bell rings. 

is Skips i lines and prints a screenful of 

lines. 

q or Q Exits from more. 
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q or :Q Same as q or Q. 

V Starts up the screen editor vi(C) at the 

current line. 

= Displays the current line number 

Repeats the previous command. What you 
type will not show on your screen, except 
for the slash (/) and exclamation (!) com- 
mands. 

' Goes to the point from which the last 

search started. If no search has been per- 
formed in the current file, this command 
goes back to the beginning of the file. 

Icommand Invokes a shell with the specified command. 

The characters % and I in command are re- 
placed with the current file name and the 
previous shell command respectively. If 
there is no current file name, % is not 
expanded. The sequences "\%" and "\!" are 
replaced by and "I" respectively. 

Up to the time when the command character itself is given, 
you can press the line kill character to cancel the numer- 
ical argument being formed. In addition, you can press 
the erase character to redisplay the "--More— (nn%)" mes- 
sage. 



Examples 

This command displays the file pretzels one screen at a 
time. 

more pretzels 

This command displays a file named marzipan, 15 lines at a 
time, beginning two lines before the expression 
"munchkin." 

more -15 +/munchkin marzipan 
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This command pipes the nroff output from the file jimlny 
through the more command so you can preview the nroff 
output. 

nroff -mm jimlny | more +2 -s 
where: 

-mm is a macro package referenced by nroff 

more pipes the nroff output through the more 



command 



-s 



removes blank lines from the output 



+2 



begins at line number 2 



Files 



/etc/termcap 
/usr /lib/more, help 



Terminal data base 
Help file 



Related Commands 



cat(C), sh(C) 



See Also 



environ(M) 
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Name 

mount, umount - Mounts and unmounts file systems and re- 
mote resources. 



Syntax 

/etc/mount [[-r -c] [-f /sfyp] special directory^ 
/etc/mount [[-r -c] [-d] resource directory'] 
/etc/umount special 
/etc/umount [-d] resource 



Description 

File systems other than root (/) are considered removable 
in the sense that they can be either available to users or 
unavailable. Mount announces to the system that special^ 
a block special device or resource^ a remote resource, is 
available to users from the mount point directory. Direc- 
tory must exist already; it becomes the name of the root 
of the newly mounted special. 

Mount, when entered with arguments, adds an entry to the 
table of mounted devices, /etc/mnttab. Umount removes th( 
entry. If invoked with no arguments, mount prints the 
entire mount table. If invoked with an incomplete argu- 
ment list, mount searches /etc/fstab for the missing argu- 
ments. 

The following options are available: 

-r Indicates that special or resource is to be 

mounted read-only. If special or resource 
is write-protected, this flag must be used. 

-d Indicates that resource is a remote re- 

source that is to be mounted on directory 
or unmounted. To mount a remote resource 
Remote File Sharing must be up and running 
and the resource must be advertised by a 
remote computer. If -d is not used, spe- 
cial must be a local block device. 

-c Does not use RFS client caching. 
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-f fstyp Indicates that fstyp is the file system 

tj^ to be mounted. If this argument is 
omitted, it defaults to the root fstyp. 

f] special Indicates the block special device that is 

*' to be mounted on directory. 

resource Indicates the remote resource name that is 

to be mounted on a directory. 

directory Indicates the directory mount point for 

special or resource. (The directory must 
already exist.) 

Umount announces to the system that the file system pre- 
viously mounted special or resource is to be made unavail- 
able. If invoked with an incomplete argument list, umount 
searches /etc/fstab for the missing arguments. 

Mount can be used by any user to list mounted file systems 
and resources. Only the super-user can mount and unmount 
file systems. 



Files 

/etc/mjittab Mount table 

/etc/fstab File system table 



See Also 

fuser(M), setmnt(C), and mount(S), umount(S), fstab(F), 
mnttab(F) in the Reference (CP, S, F). 

adv, rfstart, unadv in the Remote File Sharing manual 



Diagnostics 

If the mount(S) system call fails, mount prints an appro- 
priate diagnostic. Mount issues a warning if the file 
system to be mounted is currently mounted under another 
name. A remote resource mount will fail if the resource 
is not available or if Remote File Sharing is not running. 
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The error message "mount: Object is remote" occurs when 
an attempt is miade to mount local devices or remote re- 
sources on a directory that is remote or has a remote re- 
source mounted on it. 

Umount fails if special or resource is not mounted or if 
it is busy. Special or resource is busy if it contains an 
open file or some user's working directory. In such a 
case, you can use fuser(M) to list and kill processes that 
are using special or resource. 



Notes 

Physically removing a mounted file system diskette from 
the diskette drive before issuing the umount command dam- 
ages the file system. 
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Name 



mountall, umountall - Mounts, unmounts multiple file sys- 
tems. 



These commands may be executed only by the super-user. 

Mountall is used to mount file systems according to a 
file-system-table (/etc/fstab is the default file system 
table). The special file name "-" reads from the standard 
input. 

Before each file system is mounted, it is checked using 
fsstat(M) to see if it appears mountable. If the file 
system does not appear mountable, it is checked, using 
fsck(M), before the mount is attempted. 

Umountall causes all mounted file systems except root to 
be unmounted. The -k option sends a SIGKILL signal, via 
fuser(M), to processes that have files open. 



Syntax 



/etc/mountall [-] [file-system-table] ... 
/etc/umountall [-k] 



Description 



Files 



File-system-table format: 



column 1 



block special file name of file system 



column 2 



mount-point directory 



column 3 



"-r" if to be mounted read-only; "-d' 
if remote 



I" 



column 4 



(optional) file system type string 



colunm 5+ 



ignored 
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White-space separates columns. Lines beginning with "#" 
are comments. Empty lines are ignored. 

A typical file-system-table might read: 

/dev/dsk/cld0s2 /usr -r S51K 



See Also 



fsck(C), fsstat(M), fstab(M), fuser(M), mount(C), 
sysadm(C), and signal(S), in the Reference (CP, S, F) 



Diagnostics 

No messages are printed if the file systems are mountable 
and clean. 

Error and warning messages come from fsck(C), fsstat(M), 
and mount (C). 
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Name 

multiuser, singleuser - Causes the system to enter 
multi-user or single-user mode. 



Syntax 

/etc/multiuser 
/etc/singleuser 



Description 

This command can only be used by the super-user. 

Multiuser changes the system mode of operation from 
single-user to multi-user. Multiuser performs system 
startup functions such as mounting file systems and start- 
ing various daemons and spoolers. The /etc/telinit 2 com- 
mand is executed to tell init(M) to enter multi-user mode 
(run level 2). 

Singleuser causes the system to kill all currently running 
processes and enter system maintenance mode (run level 1). 



See Also 

init(M), shutdown(C), who(C) 
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Name 

mv - Moves or renames files and directories. 



Syntax 

mv [-f] /iZel jile2 

mv [-f] file.., directory 

mv [-f] directory 1 directory 2 



Description 

Mv moves (changes the name of) filel to jile2. 

If /ilc2 already exists, it is removed before /ilcl is 
moved. If jile2 is write-protected, mv prints the mode 
(see the chmod(C) command) and reads the standard input 
to obtain a line; if the line begins with y, the move takes 
place; if not, mv exits. 

If you use the -f (force) option, the move takes place 
regardless of /i7e2's mode. 

If you move one or more files to a specified directory, 
the files retain their original file names. 

Mv refuses to move a file onto itself. 

If filel and file2 are in different file systems, mv must 
copy the file and delete the original. The owner name 
becomes that of the copying process and any linking rela- 
tionship with other files is lost. 

Directories may not be moved across filesystems. 



Examples 

The following command changes the name of the existing 
file rhubarb to the new file name alfalfa. 

mv rhubarb alfalfa 
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This command moves the files alfalfa, alfredo, and 
alfresco to the directory /usr/al. 

mv alfalfa alfredo alfresco /usr/al 

The following command moves the directory seeds/flowers to 
the directory seeds/mums. 

mv seeds/flowers seeds/mums 

Files 

/usr/lib/mv_dir Program to move directories 

See Also 

cp(C), chmod(C) 
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Name 

nawk - Pattern scanning and processing language. 



Syntax 

nawk [-F re] [parameter.,,] Vprog^] [-f progfile] [file,,.] 



Description 

Nawk is a pattern scanner and language processor. The 
latest version of nawk provides capabilities unavailable 
in previous versions, including new built-in functions and 
variables, and the ability to use 8-bit character sets. 
The previous version of nawk is called awk(C). 

The -F re option defines the input field separator to be 
the regular expression re. 

Parameters^ in the form x=... y=.., may be passed to 
nawk, where x and y are nawk built-in variables (variables 
are discussed later). 

Nawk scans each input file for lines that match any of a 
set of patterns specified in prog. The prog string must 
be enclosed in single quotes (') to protect it from the 
shell. For each pattern in prog there may be an associ- 
ated action performed when a line of a file matches the 
pattern. The set of pattern-action statements may appear 
literally as prog or in a file specified with the -f 
progfile option. 

Input files are read in order; if there are no files, the 
standard input is read. The file name - means the stan- 
dard input. Each input line is matched against the pat- 
tern portion of every pattern-action statement; the asso- 
ciated action is performed for each matched pattern. 

An input line is normally made up of fields separated by 
white space. (This default can be changed by using the FS 
built-in variable or the -F re option.) The fields are 
denoted $1, $2, ...; $0 refers to the entire line. 
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A pattern-action statement has the form: 

pattern { action } 

^ Either pattern or action may be omitted. If there is no 

action with a pattern, the matching line is printed. If 
there is no pattern with an action, the action is per- 
formed on every input line. 

Patterns are arbitrary Boolean combinations (I, ||, &&, 
and parentheses) of relational expressions and regular 
expressions. A relational expression is one of the fol- 
lowing: 

expression relop expression 
expression matchop regular expression 

where a reZop is any of the six relational operators in C, 
and a matchop is either a (contains) or I~ (does not 
contain). A conditional is an arithmetic expression, a 
relational expression, the special expression: 

var in array 

) or a Boolean combination of these. 

The special patterns BEGIN and END may be used to 
capture control before the first input line has been read 
and after the last input line has been read, respectively. 

Regular expressions are as in egrep(C). In patterns they 
must be surrounded by slashes. Isolated regular expres- 
sions in a pattern apply to the entire line. Regular ex- 
pressions may also occur in relational expressions. A 
pattern may consist of two patterns separated by a comma; 
in this case, the action is performed for all lines be- 
tween an occurrence of the first pattern and the next oc- 
currence of the second pattern. 

A regular expression may be used to separate fields by 
using the -F re option or by assigning the expression to 
the built-in variable FS. The default is to ignore lead- 
ing blanks and to separate fields by blanks and/or tab 
characters. However, if FS is assigned a value, leading 
blanks are no longer ignored. 
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Other built-in variables include: 

ARGC Command line argument count 

ARGV Command line argument array 

FILENAME Name of the current input file 

FNR Ordinal number of the current record in the 

current file 

FS Input field separator regular expression 

(default blank) 

NF Number of fields in the current record 

(default 0) 

NR Ordinal number of the line of the current 

record 

OFMT Output format for numbers (default %.6g) 

OFS Output field separator (default blank) 

ORS Output record separator (default new-line) 

RS Input record separator (default new-line) 



An action is a sequence of statements. A statement may b 
one of the following: 

if ( conditional ) statement [ else statement ] 

while ( conditional ) statement 

do statement while ( conditional ) 

for ( expression ; conditional ; expression ) statement 

for ( vaT in array) statement 

delete array[subscript] 

break 

continue 

{ [ statement ] ... } 

expression # commonly variable = expression 

print [ expression-list ] [ >expression ] 

printf format [, expression-list ] [ >expression] 

next # skip remaining patterns on this input line 

exit [expr] # skip the rest of the input; exit status 

# is expr 
return [expr] 
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Statements are terminated by semicolons, new-lines, or 
right braces. An empty expression-list stands for the 
whole input line. Expressions take on string or numeric 
values as appropriate, and are built using the operators 

>j +, -, *, /, and concatenation (indicated by a blank). 

/ The C operators ++, ~, +=, -=, *=, /=, and are also 

available in expressions. Variables may be scalars, array 
elements (denoted x[i]), or fields. Variables are in- 
itialized to the null string or zero. Array subscripts 
may be any string, not necessarily numeric; this allows 
for a form of associative memory. String constants are 
quoted ("). 

The print statement prints its arguments on the standard 
output, or on a file if >expression is present, or on a 
pipe if I cmd is present. The arguments are separated by 
the current output field separator and terminated by the 
output record separator. The printf statement formats its 
expression list according to a format string (see 
printf(S) in the Reference (CP, S, F)). 

Nawk has a variety of built-in functions: arithmetic, 
string, input/output, and general. 

y 

The arithmetic functions are: atan2, cos, exp, int, log, 
rand, sin, sqrt, and srand. Int truncates its argument to 
an integer. Rand returns a random number between 0 and 1. 
Srand ( expr ) sets the seed value for rand to expr or 
uses the time of day if expr is omitted. 

The string functions are: 

gsub(/or, repU in) 

Behaves like sub (see below), except that 
it replaces successive occurrences of the 
regular expression (like the ed(C) global 
substitute command). 

Returns the position in string s where 
string f first occurs, or 0 if it does not 
occur at all. 

Returns the length of its argument taken as 
a string, or of the whole line if there is 
no argument. 



index(s, t) 



^J length (s) 
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match(s, re) Returns the position in string s where the 
regular expression re occurs, or 0 if it 
does not occur at all. RSTART is set to 
the starting position (which is the same as 
the returned value), and RLENGTH is set to 
the length of the matched string. 

split(s, a, fs) 

Splits the string s into array elements 
all], a[2], a[n], and returns n. The sep- 
aration is done with the regular expression 
fs or with the field separator FS if fs is 
not given. 

sprintf (/mt, cxpr, expr,...) 

Formats the expressions according to the 
printf(S) format given by fmt and returns 
the resulting string. 

sub(/or, repU in) 

Substitutes the string repl in place of the 
first instance of the regular expression 
for in string in and returns the number of 
substitutions. If in is omitted, nawk sub- 
stitutes in the current record ($0). 



substr(s, m, n) 



Returns the n-character substring of s 
that begins at position m. 



The input/output and general functions are: 
close(/ii[ename) 

Closes the file or pipe named filename. 

cmd Igetline Pipes the output of cmd into getline; each 
successive call to getline returns the next 
line of output from cmd. 

getline Sets $0 to the next input record from the 

current input file. 

getline <file Sets $0 to the next record from file. 

getline var Sets variable var instead. 
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getline var <file 

Sets var from the next record of file. 

system( cmd) Executes cmd and returns its exit status. 

All forms of getline return 1 for successful input, 0 for 
end of file, and -1 for an error. 

Nawk also provides user-defined functions. Such functions 
may be defined (in the pattern position of a 
pattern-action statement) as 

function nameiargs,...) { stmts } 
func nameiargs,...) { stmts } 

Function arguments are passed by value if scalar and by 
reference if array name. Argument names are local to the 
function; all other variable names are global. Function 
calls may be nested and functions may be recursive. The 
return statement may be used to return a value. 



Examples 

The following examples are taken from a file. 
Print lines longer than 72 characters: 

•length > 72' 
Print the first two fields in opposite order: 

'{ print $2, $1 }• 

Same as above, with input fields separated by comma and/or 
blanks and tabs: 

'BEGIN { FS = ",[ \t]*[ \t]+" } 
{ print $2, $1 }* 

Add up the first column, print the sum and average: 

•{ s += $1 } 

END { print "sum is", s, " average is", s/NR }' 
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Print fields in reverse order: 

•{ for (i = NF; i > 0; — i) print $i }• 
Print all lines between start/stop pairs: 

•/start/, /stop/' 

Print all lines whose first field is different from pre- 
vious one: 

'$1 1= prev { print; prev = $1 }' 

Simulate echo(C): 

'BEGIN { 

for (i = 1; i < ARGC; i++) 

printf "%s", ARGV[il 
printf "\n" 
exit 
}• 

Print file, filling in page numbers starting at 5: 

/Page/ { $2 = n++; } 
{ print } 

command line: nawk -f program n=5 input 



See Also 

grep(C), awk(C), sed(C), lex(C) 
printf(S) in the Programmer's Guide 



Notes 

Input white space is not preserved on output if fields are 
involved. 

There are no explicit conversions between numbers and 
strings. To force an expression to be treated as a num- 
ber, add 0 to it; to force it to be treated as a string, 
concatenate the null string ("") to it. 
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Name 

newgrp - Logs user in to a new group. 



Syntax 

newgrp [-] [ group ] 



Description 

Newgrp changes a user's group identification. The user 
remains logged in and the current directory is unchanged, 
but calculations of access permissions to files are per- 
formed with respect to the new real and effective group 
IDs. The user is always given a new shell, replacing the 
current shell, by newgrp, regardless of whether it termi- 
nated successfully or due to an error condition (e.g., 
unknown group). 

Exported variables retain their values after invoking 
newgrp; however, all unexported variables are either reset 
to their default value or set to null. System variables 
(such as PSl, PS2, PATH, MAIL, and HOME), unless ex- 
ported by the system or explicitly exported by the user, 
are reset to default values. For example, suppose a user 
has a primary prompt string (PSl) other than $ (default) 
and has not exported PSl. After an invocation of newgrp, 
successful or not, their PSl will now be set to the de- 
fault prompt string $. Note that the shell command export 
(see sh(C)) is the method to export variables so that they 
retain their assigned value when invoking new shells. 

With no arguments, newgrp changes the group identification 
back to the group specified in the user's password file 
entry. This is a way to undo the effect of an earlier 
newgrp command. 

If the first argument to newgrp is a -, the environment is 
changed to what would be expected if the user actually 
logged in again as a member of the new group. 

A password is demanded if the group has a password and 
the user does not, or if the group has a password and the 
user is not listed in /etc/group as being a member of that 
group. 
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Files 



/etc/group 
/etc/passwd 



System's group file 
System's password file 



See Also 



login(C), sh(C), environ(M) group(M), passwd(M) 



Notes 



There is no convenient way to enter a password into 
/etc/group. Use of group passwords is not encouraged, 
because, by their very nature, they encourage poor secur- 
ity practices. Group passwords may disappear in the fu- 
ture. 
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Name 

nice - Runs a command at a different priority. 



Syntax 

nice [ -increment ] command [ arguments ] 



Description 

Nice executes command with a lower CPU scheduling prior- 
ity. Nice values range from 0 to 39, where 0 yields the 
highest priority and 39 the lowest. By default, commands 
have a value of 20. 

If an -increment argument is given, where increment is in 
the range 1-19, increment is added to the default nice of 
20 to produce a numerically higher value, meaning a lower 
scheduling priority. 

If no increment is given, an increment of 10 to produce a 
value of 30 is assumed. 

The super-user may run commands with a higher priority 
than normal by using a double negative increment. For 
example, an argument of "~10" would decrement the default 
to produce a value of 10, increasing the scheduling prior- 
ity. 



See Also 

nice(S), nohup(C) 



Diagnostics 

Nice returns the exit status of the subject command. 



Notes 

If you specify a value outside the range, a value greater 
than 39 is equivalent to 39; a value less than zero is 
equivalent to zero. 



1 



NL(C) 



NL(C) 



Name 

nl - Adds line numbers to a file. 



Syntax 

nl [ -htype ] [ -htype ] [ -ftype ] [ -vstart #] [ -iincr ] 
[ -p ] [ -Inum ] [ -ssep ] [ -wwidth ] [ -nformat ] 
[ -ddelim ] [file] 



Description 

Nl reads lines from the named /ile, or from the standard 
input if no file is named, and reproduces the lines on the 
standard output. Lines are numbered on the left in accor- 
dance with the command options in effect. 

Nl views the text it reads in terms of logical pages. 
Line numbering is reset at the start of each logical page. 
A logical page consists of a header, a body, and a footer 
section. Empty sections are valid. Different line num- 
bering options are available independently for header, 
body, and footer (e.g., no numbering of header and footer 
lines while numbering blank lines in the body). 

The start of logical page sections is signaled by input 
lines containing nothing but the following character(s): 

Page Section Line Contents 

Header \:\:\: 
Body \:\: 
Footer \: 

Unless signaled otherwise, nl assumes the text being read 
is in a single logical page body. 

Command options may appear in any order and may be inter- 
mingled with an optional filename. Only one file may be 
named. The options are: 
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-htype Specifies which logical page body lines are to 

be numbered. Recognized types and their mean- 
ing are: 

a number all lines 

t number lines with printable text only 

(the default) 



p string 



no line numbering 

number only lines that contain the 
regular expression specified in string 



-htype Same as -bfype except for header. The default 
tj^e for logical page header is n (no lines 
numbered). 

-ttype Same as -htype except for footer. The default 
for logical page footer is n (no lines 
numbered). 

-p Does not restart numbering at logical page de- 

limiters. 

-vstart# Starts is the initial value used to number log- 
ical page lines. The default is 1. 

-iincr Incr is the increment value used to number log- 
ical page lines. The default is 1. 

-ssep Sep is the character (s) used in separating the 
line number and the corresponding text line. 
Default is TAB. 

-wwidth Width is the number of characters to be used for 
the line number. The default width is 6. 



-nformat Format is the line numbering format. The recog- 
nized values are: In, left justified, leading 
zeroes suppressed; m, right justified, leading 
zeroes suppressed; rz, right justified, leading 
zeroes kept. The default format is m (right 
justified). 
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-Inum Num is the number of blank lines to be con- 
sidered as one. For example, -12 results in 
only the second adjacent blank being numbered 
(if the appropriate -ha, -ba, and/or -fa option 
is set). The default is 1. 

-dxx You can change the delimiter characters, xx, 

specifying the start of a logical page section, 
from the default characters (\:) to two 
user-specified characters. If you enter only 
one character, the second character remains the 
default character (:). Do not enter a space 
between -d and the delimiter characters. To 
enter a backslash (\) use two backslashes (\\). 



Example 

The command: 

nl -vlO -110 -d!+ filel 

will number filel starting at line number 10 with an in- 
crement of ten. The logical page delimiters are !+. 



See Also 

num(C), pr(C) 
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Name 

nohup - Runs a command immune to hangups and quits. 

) 

Syntax 

nohup command [ arguments ] 



Description 

Nohup executes command with hangups and quits ignored. 
If output is not redirected by the user, it will be sent 
to nohup. out. If nohup. out is not writable in the current 
directory, output is redirected to $HOME /nohup. out. 



Examples 

It is frequently desirable to apply nohup to pipelines or 
lists of commands. This can be done only by placing pipe- 
lines and command lists in a single file, called a shell 
procedure. You can then issue: 

nohup sh file 

and the nohup applies to everything in file. If the shell 
procedure file is to be executed often, then the need to 
type sh can be eliminated by giving file execute permis- . 
sion. Add an ampersand and the contents of file are run 
in the background with interrupts also ingnored (see 
sh(C)): 

nohup file & 

An example of what the contents of file could be is: 
sort ofile > nfile 



See Also 

nice(C), sh(C), signal(S) 
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Notes 

The command: 

nohup coinmandl;command2 
nohup applies only to commandl. To correct this, use: 

nohup {commandl;command2) 
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Name 

num - Numbers lines. 

Syntax 

num [ file.,. ] 

Description 

The lines in the specified /i/es, or the standard input, 
are copied to the standard output preceded by line num- 
bers. Tabs remain aligned in the ouput as the lines are 
printed preceded by the number, blank padded to six 
digits, and then two spaces. 

See Also 

see(C), nl(C) 
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Name 

od - Displays files in octal format. 



Syntax 

od [ -bcdhosx ] [ file ] [ [ + ] offset [ . ][ b ] ] 



Description 

Od displays file in one or more formats as selected by the 
first argument (-o is default). The format options are: 

-b Interprets bytes in octal. 

-e Interprets bytes in ASCII. Certain nongraphic char- 
acters appear as C escapes: null=\0, BACKSPACE=\b, 
FORMFEED=\f, NEWLINE=\n, RETURN=\r, TAB=\t; 
Others appear as 3-digit octal numbers. 

-d Interprets words in decimal. 

-h Interprets words in hexadecimal (same as -x). 

-o Interprets words in octal. 

-s Interprets words in signed decimal. 

-X Interprets words in hexadecimal (same as -h). 

The file argument specifies which file is to be displayed. 
If no file argument is specified, the standard input is 
used. 

The offset argument (normally interpreted as octal bytes) 
specifies the offset in the file where the display is to 
start. If . is appended, the offset is interpreted in 
decimal. If b is appended, the offset is interpreted in 
512-byte blocks. If file is omitted, offset must be pre- 
ceded by +. The display continues until EOF. 



See Also 

adb(C), hd(C) 
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Name 

pack) peat, unpack - Compresses and expands files. 

I, 

^ Syntax 

pack [ - ] [ -f ] name ... 
peat name ... 
unpack name ... 



Description 

Pack attempts to store the specified files in a compressed 
form. Wherever possible (and useful), each input file 
name is replaced by a packed file name.z with the same 
access modes, access and modified dates, and owner as 
those of name. The -f option will force packing of name. 
This is useful for causing an entire directory to be 
packed even if some of the files will not benefit. If 
pack is successful, name will be removed. Packed files 
can be restored to their original form using unpack or 
peat. 

Pack uses Huffman (minimum redundancy) codes on a byte- 
by-byte basis. If the - argument is used, an internal 
flag is set that causes the number of times each byte is 
used, its relative frequency, and the code for the byte to 
be printed on the standard output. Additional occurrences 
of - in place of name will cause the internal flag to be 
set and reset. 

The amount of compression obtained depends on the size of 
the input file and the character frequency distribution. 
Because a decoding tree forms the first part of each .z 
file, it is usually not worthwhile to pack files smaller 
than three blocks, unless the character frequency distri- 
bution is very skewed, which may occur with printer plots 
or pictures. 

Typically, text files are reduced to 60-75% of their 
original size. Load modules, which use a larger character 
set and have a more uniform distribution of characters, 
show little compression, the packed versions being about 
90% of the original size. 
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Pack returns a value that is the number of files that it 
failed to compress. No packing will occur if: 

• The file appears to be already packed 

• The filename has more than 12 characters 

• The file has links 

• The file is a directory 

• The file cannot be opened 

• No disk storage blocks will be saved by packing 

• A file called name.z already exists 

• The .z file cannot be created 

• An I/O error occurred during processing 

The last segment of the filename must not contain more 
than 12 characters to allow space for the appended .z ex- 
tension. Directories cannot be compressed. 

Peat does for packed files what cat(C) does for ordinary 
files. The specified files are unpacked and written to 
the standard output. Thus, to view a packed file named 
name.z use: 

peat name.z 

or just: 

peat name 

To make an unpacked copy, say nnn, of a packed file, 
name.z (without destroying name.z), use the command: 

peat name >nnn 

Peat returns the number of files it was unable to unpack. 
Failure may occur if: 

• The filename (exclusive of the .z) has more than 12 
characters 
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• The file cannot be opened 

• The file does not appear to be the output of pack 

Unpack expands files created by pack. For each name file 
specified in the command, a search is made for a file 
called name.z (or just name, if name ends in .z). If this 
file appears to be a packed file, it is replaced by its 
expanded version. The new file has the .z suffix stripped 
from its name, and has the same access iiKxies, access and 
modification dates, and owner as those of the packed file. 

Unpack returns a value that is the number of files it was 
unable to unpack. Failure may occur for the same reasons 
that it may in peat, as well as in a file where the 
"unpacked" name already exists, or if the unpacked file 
cannot be created. 



See Also 

cat(C), passwd(M) 
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Name 

passwd - Changes login password. 



Syntax 

passwd [ name ] 



Description 

This command changes or installs a password associated 
with the login name. 

Ordinary users may change only the password which corres- 
ponds to their login name. 

Passwd prompts ordinary users for their old password, if 
any. It then prompts for the new password twice. The 
first time the new password is entered, passwd checks to 
see if the old password has "aged" sufficiently. Password 
"aging" is the amount of time (usually a certain number of 
days) that must elapse between password changes. If 
"aging" is insufficient the new password is rejected and 
passwd terminates; see passwd(F). Note that password 
aging is NOT enabled by default. See passwd(M) for more 
information. 

Assuming "aging" is sufficient, a check is made to insure 
that the new password meets construction requirements. 
When the new password is entered a second time, the two 
copies of the new password are compared. If the two 
copies are not identical the cycle of prompting for the 
new password is repeated for at most two more times. 

Passwords must be constructed to meet the following re- 
quirements: 

• Each password must have at least six characters. 
Only the first eight characters are significant. 

• Each password must contain at least two alphabetic 
characters and at least one numeric or special char- 
acter. In this case, "alphabetic" means upper and 
lower-case letters. 
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• Each password must differ from the user's login name 
and any reverse or circular shift of that login name. 
For comparison purposes, an upper case letter and its 
corresponding lower-case letter are equivalent. 

• New passwords must differ from the old by at least 
three characters. For comparison purposes, an upper 
case letter and its corresponding lower-case letter 
are equivalent. 

One whose effective user ID is zero is called a super- 
user; see id(C) and su(C). Super-users may change any 
password; hence, passwd does not prompt super-users for 
the old password. Super-users are not forced to comply 
with password aging and password construction require- 
ments. A super-user can create a null password by enter- 
ing a carriage return in response to the prompt for a new 
password. 



Files 

/etc/passwd 



See Also 

login(C), id(M), su(M) and crypt(S), passwd(F) in the 
Reference (CP, S, F) 
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Name 

pconfig - Port configuration utility. 

Syntax 

pconfig [ -f I -h I -i ] 

Description 

The pconfig command defines port configuration information 
for your system; with pconfig, you can set up ports on 
your computer as terminal, modem, or printer devices. You 
can also set parameters, such as communication speed (baud 
rate) and terminal type for these devices. 

You must be the super-user to use this command. 

Options 

The options are as follows: 

-f Forces execution even if someone else is using 
pconfig 

-h Displays a brief help introduction 
-i Initializes modem ports 

After you invoke the pconfig command, the prompt at the 
bottom of the screen asks you to type one of the following 
commands: 

a Adds a new port specification 
c Changes a port assignment 
d Deletes a port assignment 

q Updates the system port assignment files, then termi- 
nates the program 

r Configures a remote printer. 
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Displays help information 

! Passes a command to the operating system for execu- 
tion 

Each of these command options is described below. To 
select an opti on, just type the character. You do not 
need to press BblSBM . When executing one of the options, 
you may, however, be a sked to enter a word. In this case, 
fo llow th e word with a BMBMI . In most cases, entering just 
a KMIIW will leave that particular command or attribute 
unchanged. 

a Add a port. The named port will be added to the port 
configuration list, and eventually to the 
/etc/inittab file. 

c Change a port. You will be asked to specify the port 
to change. Enter the name of the port as it appears 
when you use the d option to display the port assign- 
ments. You will be asked to enter the device type: 
terminal, printer, or other. 

Select terminal, and you will be asked to specify the ter- 
minal, then the action for the port. "Respawn" means the 
port is enabled, "off" means disabled. Finally, you will 
be asked for the baud rate (communication speed) of the 
port. The baud rate is determined by the protocol defined 
in the /etc/gettydefs file, and is selected by an identi- 
fier that is in the first field of each line in 
/etc/gettydefs. Enter the desired identifier to set the 
baud rate. 

To set the port up as a modem, select the identifier that 
contains the word "MODEM." For a bidirectional line (dial 
out and dial in), select the identifier that contains 
"UUCP." 

Select printer, and you will be asked to enter the name of 
the printer, which can be Ip or IpNiV, where NN is a digit 
between 0 and 255. Enter the baud rate as described 
above. 

Select other only if you want to directly edit the fields 
within the /etc/inittab file. These fields will then be 
written to the /etc/inittab file without error checking. 
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q Quits the program. If any changes have been made to 
the port assignments, you will be asked if you want 
to save the changes. Type y to install the new con- 
figuration, or ri to exit the program without making 
any changes. 

I Escapes to a sub-shell invoked from within peonfig. 
If the SHELL environment variable is initialized, the 
specified shell will be run; if not, /bin/sh is in- 
voked. 

During the execution of the quit command, the /etc/inittab 
file is copied to /etc/oinittab. Thus, if a problem 
occurs during the use of this program, you can recover the 
prior state of the port configurations. 



Files 

/etc/inittab 
/etc/gettydefs 
/etc/printers 
/usr/lib/PCF 



See Also 

init(M), inittab(M), getty(M), gettydefs(M) 
OpeTations Guide 
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Name 

pg - File perusal filter for CRTs. 



Syntax 

pg [-number] [-p string] [-cefns] [+Unenumber] 
[+/pattem/] [files...] 



Description 

The pg command is a filter that allows the examination of 
files one screenful at a time on a CRT. (The file name 
dash (-) and/or NULL arguments indicate that pg should 
read from the standard input.) Each screenful is followed 
by a prompt. If you type a carriage return, another page 
is displayed; other possibilities are enumerated below. 



This command is different from previous paginators in that 
it allows you to back up and review something that has 
already passed. The method for doing this is explained 
below. 

In order to determine terminal attributes, pg scans the 
terminfo(M) data base for the terminal type specified by 
the environment variable TERM. If TERM is not defined, 
the terminal type "dumb" is assumed. 



The command line options are: 



-number An integer specifying the size (in lines) of the 
window that pg is to use instead of the default. 
(On a terminal containing 24 lines, the default 
window size is 23.) 



-p string Causes pg to use string as the prompt. If the 
prompt string contains a "%d", the first occur- 
rence of "%d" in the prompt will be replaced by 
the current page number when the prompt is 
issued. The default prompt string is 

-c Moves the cursor to home and clears the screen 

before displaying each page. This option is 
ignored if clear screen is not defined for this 
terminal type in the terminfo(M) data base. 
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-e 



Causes pg not to pause at the end of each file. 



-f 



Normally, pg splits lines longer than the screen 
width, but some sequences of characters in the 
text being displayed (e.g., escape sequences for 
underlining) generate undesirable results. The 
-f option inhibits pg from splitting lines. 



-n 



Normally, commands must be terminated by a 
Newline character. This option causes an auto- 
matic end of command as soon as a command 
letter is entered. 



-s 



Causes pg to print all messages and prompts in 
standout mode (usually inverse video). 



+linenumber 

Start up at linemmber. 

*/pattern/ 

Start up at the first line containing the reg- 
ular expression pattern. 

The responses that may be typed when pg pauses can be di- 
vided into three categories: those causing further per- 
usal, those that search, and those that modify the perusal 
environment. 

Commands that cause further perusal normally take a pre- 
ceding address, an optionally signed number indicating the 
point from which further text should be displayed. This 
address is interpreted in either pages or lines depending 
on the conmiand. A signed address specifies a point rela- 
tive to the current page or line, and an unsigned address 
specifies an address relative to the beginning of the 
file. Each command has a default address that is used if 
none is provided. 

The perusal commands and their defaults are as follows: 

(+l)<Newline> or <Blank> 

This causes one page to be displayed. The 
address is specified in pages. 
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(+1) 1 With a relative address this causes pg to simu- 
late scrolling the screen, forward or backward, 
the number of lines specified. With an absolute 
address this commiand prints a screenful beginni- 

V ng at the specified line. 

^' 

(+1) d or 

Simulates scrolling half a screen forward or 
backward. 

The following perusal commands take no address. 

. or Causes the current page of text to be 

redisplayed. 

$ Displays the last windowful in the file. Use 

with caution when the input is a pipe. 

The following commands are available for searching for 
text patterns in the text. The regular expressions de- 
scribed in ed(C) are available. They must always be ter- 
minated by a <Newline>, even if the -n option is speci- 
fied. 

i/ pattern/ 

Search forward for the ith (default i=l) 
occurrence of pattern. Searching begins im- 
mediately after the current page and continues 
to the end of the current file, without wrap- 
around. 

r pattern" 
i7pattern? 

Search backwards for the ith (default i=l) oc- 
currence of pattern. Searching begins immedi- 
ately before the current page and continues to 
the beginning of the current file, without wrap- 
around. The " notation is useful for Adds 100 
terminals which will not properly handle the ?. 

After searching, pg will normally display the line found 
at the top of the screen. This can be modified by append- 
ing m or b to the search command to leave the line found 
in the middle or at the bottom of the window from now on. 
The suffix t can be used to restore the original situa- 
tion. 
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You can modify the environment of perusal with the follow- 
ing commands: 

m Begin perusing the ith next file in the command 

line. The i is an unsigned number, default 
value is 1. 

ip Begin perusing the ith previous file in the com- 

mand line. The i is an unsigned number, default 
is 1. 

iw Display another window of text. If i is pres- 

ent, set the window size to i. 

s filename 

Save the input in the named file. Only the 
current file being perused is saved. The white 
space between the s and filename is optional. 
This command must always be terminated by a 
<Newline>, even if the -n option is specified. 

h Help by displaying an abbreviated summary of 

available commands. 

q or Q Quit pg. 

Icommand Command is passed to the shell, whose name is 
taken from the SHELL environment variable. If 
this is not available, the default shell is 
used. This command must always be terminated 
by a <Newline>, even if the -n option is spe- 
cified. 

At any time when output is bein g sent to the terminal, you 
can press the quit key (normally the interrupt 

( MiV/St\M ) key. This causes pg to stop sending output, and 
display the prompt. You may then enter one of the above 
commands in the normal manner. Unfortunately, some out- 
put is lost when this is done, due to the fact that any 
characters waiting in the terminal's output queue are 
flushed when the quit signal occurs. 

If the standard output is not a terminal, then pg acts 
just like cat{C), except that a header is printed before 
each file (if there is more than one). 
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Example 

A sample usage of pg in reading system news would be: 
news I pg -p"(Page%d):" 



Notes 

While waiting for terminal input, pg responds to UAfe^M . 
■iraB . and " by terminating execution. Between prompts, 
however, these signals interrupt pg's current task and 
place you in prompt mode. These should be used with cau- 
tion when input is being read from a pipe, since an inter- 
rupt is likely to terminate the other commands in the 
pipeline. 

Users of Berkeley's more will find that the z and f com- 
mands are available, and that the terminal /, or ? may 
be omitted from the searching commands. 



Files 



/usr/lib/terminfo/?/* Terminal information database 

/tmp/pg* Temporary file when input is 

from a pipe 



See Also 

ed(C), grep(C), terminfo(M) 



Bugs 

If terminal tabs are not set every eight positions, unde- 
sirable results may occur. 

When using pg as a filter with another command that 
changes the terminal I/O options, terminal settings may 
not be restored correctly. 
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Name 

pr - Prints files. 



Syntax 

pr [ [-column] [-wwidth] [-a] ] [-ecfe] [-ick] [-drtfp] 
[+page] [-nek] [-ooffset] [-llength] [-sseparatOT] 
[-h header] [file...] 

pr [ [-m] [-wwidth] ] [-eck] [-ick] [-drtfp] [*page] 
[-nek] [-ooffset] [-llength] [-sseparator] [-h header] 
filel file2... 



Description 

Pr is used to format and print the contents of a file. If 
file is -, or if no files are specified, pr assumes stan- 
dard input. Pr prints the named files on standard output. 

By default, the listing is separated into pages, each 
headed by the page number, a date and time, and the name 
of the file. Page length is 66 lines which includes 10 
lines of header and trailer output. The header is com- 
posed of 2 blank lines, 1 line of text (can be altered 
with -h), and 2 blank lines; the trailer is 5 blank lines. 
For single column output, line width may not be set and is 
unlimited. For multi-column output, line width may be set 
and the default is 72 columns. Diagnostic reports (failed 
options) are reported at the end of standard output asso- 
ciated with a terminal, rather than interspersed in the 
output. Pages are separated by series of line feeds 
rather than form feed characters. 

By default, columns are of equal width, separated by at 
least one space; lines which do not fit are truncated. If 
the -s option is used, lines are not truncated and columns 
are separated by the separator character. 

Either -column or -m should be used to produce 
multi-column output, -a should only be used with -column 
and not -m. 
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Command line options are: 
+page 



-column 



-m 



-eck 



-ick 



Begin printing with page numbered page 
(default is 1). 

Print column columns of output (default is 
1). Output appears as if -e and -1 are 
turned on for multi-column output. May not 
use with -m. 

Print multi-column output across the page 
one line per column. Columns must be 
greater than one. If a line is too long to 
fit in a column, it is truncated. 

Merge and print all files simultaneously, 
one per column. The maximum number of 
files that may be specified is eight. If a 
line is too long to fit in a column, it is 
truncated. May not use with -column. 

Double-space the output. Blank lines that 
result from double-spacing are dropped when 
they occur at the top of a page. 

Expand input tabs to character positions 
fe+1, 2*fe+l, 3*/?+l, etc. If is 0 or is 
omitted, default tab settings at every 
eighth position are assumed. Tab charac- 
ters in the input are expanded into the 
appropriate number of spaces. If c (any 
non-digit character) is given, it is 
treated as the input tab character (default 
for c is the tab character). 

In output, replace white space wherever 
possible by inserting tabs to character 
positions fe+1, 2*fe+l, 3*fe+l, etc. If k is 
0 or is omitted, default tab settings at 
every eighth position are assumed. If c 
(any non-digit character) is given, it is 
treated as the output tab character 
(default for c is the tab character). 
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-nek 



Provide fe-digit line numbering (default for 
k is 5). The number occupies the first fe+1 
character positions of each column of 
single column output or each line of -m 
output. If c (any non-digit character) is 
given, it is appended to the line number to 
separate it from whatever follows (default 
for c is a tab). 



-wmidth Set the width of a line to width character 

positions (default is 72). This is effec- 
tive only for multi-column output {-column 
and -m). There is no line limit for single 
column output. 

-ooffset Offset each line by offset character posi- 

tions (default is 0). The number of char- 
acter positions per line is the sum of the 
width and offset. 

-llength Set the length of a page to length lines 

(default is 66). -10 is reset to -166. 
When the value of length is 10 or less, -t 
appears to be in effect since headers and 
trailers are suppressed. By default, out- 
put contains 5 lines of header and 5 lines 
of trailer leaving 56 lines for user- 
supplied text. When -llength is used and 
length exceeds 10, then length-lO lines are 
left per page for user supplied text. When 
length is 10 or less, header and trailer 
output is omitted to make room for user 
supplied text. 

-h header Use header as the text line of the header 

to be printed instead of the file name, -h 
is ignored when -t is specified or -llength 
is specified and the value of length is 10 
or less, (-h is the only pr option requir- 
ing space between the option and argument. 



Pause before beginning each page if the 
output is directed to a terminal (pr will 
ring the bell at the terminal and wait for 
a carriage return). 
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Use single form-feed character for new 
pages (default is to use a sequence of 
line-feeds). Pause before beginning the 
first page if the standard output is asso- 
ciated with a terminal. 

Print no diagnostic reports on files that 
will not open. 

Print neither the five-line identifying 
header nor the five-line trailer nonnally 
supplied for each page. Quit printing 
after the last line of each file without 
spacing to the end of the page. Use of -t 
overrides the -h option. 

-sseparator Separate columns by the single character 
separator instead of by the appropriate 
number of spaces (default for separator is 
a tab). Prevents truncation of lines on 
multicolumn output unless -w is specified. 



Examples 

Print filel and file2 as a double-spaced, three-column 
listing headed by "file list": 

pr -3dh "file list" filel file2 

Copy filel to file2, expanding tabs to columns 10, 19, 28, 
37,... : 

pr -e9 -t Kfilel >file2 

Print filel and file2 simultaneously in a two-column list- 
ing with no header or trailer where both columns have line 
numbers: 

pr -t -n filel \ pr -t -m -n file2 - 



) 



-f 



) 



-r 



-t 
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Files 

/dev/tty* To delay messages enabling them to print at 

the bottom of files rather than interspersed 
throughout printed output. 



See Also 

cat(C), pg(C) 
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Name 

printenv - Prints out the environment. 

Syntax 

printenv [ name ] 

Description 

Printenv prints out the values of the variables in the 
environment. If a name is specified, only its value is 
printed. 

If a name is specified and it is not defined in the en- 
vironment, printenv returns exit status 1; otherwise, it 
returns status 0. 



See Also 

sh(C), environ(M), csh(C) 
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Name 

ps - Reports process status. 



Syntax 

ps [-adefl] [-C corefile] [s swapdev] l-t tlist] 
[-p plist] [-U ulist] l-g glist] 



Description 

Ps prints certain information about active processes. If 
you use the ps command without arguments, it lists infor- 
mation about processes associated with the current ter- 
minal. If you use arguments with the ps command, more 
specialized information is listed. 



Options 

-a Prints information about all processes, 

except process group leaders and processes 
not associated with a terminal. 

-c corefile Uses the file corefile in place of 
/dev/mem. 

-d Prints information about all processes, 

except process group leaders. 

-e Prints information about all processes. 

-f Generates a full listing. Normally, a 

short listing containing only process ID, 
terminal ("tty") identifier, cumulative 
execution time, and the command name is 
printed. See below for a description of 
each column in a full listing. 

Under the -f option, ps tries to determine 
the command name and arguments given 
when the process was created by examining 
memory or the swap area. Failing this, the 
command name, as it would appear without 
the -f option, is printed in square brackets. 
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-g glist Lists information about processes whose 

process groups are given in glist. Glist 
is a list of process group leaders and is 
in the same format as tlist. 

-1 Generates a long listing. See below. 

-p plist Lists information about processes whose 

process ID numbers are given in plist, 
Plist is in the same format as tlist. 



-s swapdev Uses the file swapdev in place of 

/dev/swap. This is useful when examining a 
corefile. 



-t tlist Lists information about the processes 

associated with the terminals given in 
tlist. Tlist can be in one of two forms: 
a list of terminal identifiers separated 
from one another by a comma, or a list of 
terminal identifiers enclosed in double 
quotes and separated from one another by a 
comma and/or one or more spaces. 

') 

" -u ulist Lists information about processes whose 

user ID numbers or login names are given in 
ulist. Ulist is in the same format as 
tlist. In the listing, the numerical user 
ID is printed unless the -f option is used, 
in which case the login name is printed. 



When you type a ps command, the status of all processes 
running on your system is displayed in colunms across your 
screen. The meaning of each colunm in a ps listing is 
given below, as well as the options that cause that column 
to appear (-1 for the long option and -f for the full 
option). When all is listed as the option, it means that 
the column always displays no matter what option you 
enter. 



2 



PS(C) 



PS(C) 



A status word consisting of flags asso- 
ciated with the process. Each flag is 
associated with a bit in the status word. 
These flags are ored to form a single hex 
number. 

Process flag bits and their meanings are: 



Column 

Heading Option Description 



F 1 



0x00001 
0x00002 
0x00004 

0x00008 

0x00010 
0x00020 
0x00040 
0x00080 
0x00100 

0x00200 
0x00400 
0x00800 
0x01000 
0x02000 
0x04000 

0x08000 
0x10000 
0x20000 

0x40000 

0x80000 



System (resident) process. 
Process is being traced. 
Stopped process given to 

parent by wait system call. 
Process cannot wakeup by a 

signal. 
In core. 

Process cannot be swapped. 
Set when signal goes remote. 
Process in stream poll. 
Process is being stopped via 
/proc. 

Signal tracing via /proc. 

Doing 1/0 via /proc. 

Stop on exec. 

Process is open via /proc. 

U-block is in core. 

Set process to run on last 

/proc close. 
Process asleep. 

Processing exiting via ptrace. 
Process stopped within a call 

to sleep. 
U-block is being swapped in 

or out. 

Waiting for u-block swap to 
complete. 
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Column 

Heading Option Description 



UID 



PID 



f,l 



all 



PPID f,l 
C f.l 

STIME f 
PRI 

P 
NI 

ADDR 
SZ 



The 


state of the process 


0 


non-existent 


S 


sleeping 


W 


waiting 


R 


runable 


I 


intermediate 


Z 


terminated 


T 


stopped 


X 


waiting for memory 


P 


running 



The user ID number of the process owner; 
the login name is printed under the -f 
option. 

The process ID of the process; it is 
possible to kill a process if you know 
this data. 

The process ID of the parent process. 

Process utilization for scheduling, in 
hex. 

Starting time of the process. 

The priority of the process; higher 
numbers mean lower priority. 

CPU on which process last run. 

Nice value; used in priority 
computation. 

The memory address of the process, if 
resident; otherwise, the disk address. 

The virtual size in IK units of the stack 
and data regions process. 
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Column 
Heading 



Option Description 



WCHAN 1 The event for which the process is 

waiting or sleeping; if blank, the process 
is runable, in hex. 

TTY all The controlling terminal for the process. 

If using windows, also shows number of the 
window in which process is running. 

TIME all The cumulative executive time for the 
process. 

CMD all The command name; the full command name 
and its arguments are printed under the 
-f option. 

A process that has exited and has a parent, but has not 
yet been waited for by the parent, is marked <defunct>. 



Examples 

This command lists your processes using the long form, 
ps -1 



F S UIt> PlO J>I'10 C I>RI NI ADDS, SZ WCHM StiME TtY TIME CMD 
1 S 109 160S 1 0 30 20 57 24 aac8 09:07:12 3/2 0:06 sh 
1 R 10* 5656 1605 23 61 20 63 32 09:30:20 4/0 0:03 ps 
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Files 

/dev/mem Memory 

/dev Searched to find swap device and ter- 

minal ("tty") names 

/dev/swaptab Contains kernel structure list of all 

swap devices 



Related Commands 
kill(C) 



Notes 

If ps can't find the swap device, you will see an error 
message: 

Cannot open swapdev 

where swapdev is a swap device such as /dev/hdOa. 
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Name 

pscreen - Sets up terminal to enable print-screen capabil- 
ity. 



Syntax 

pscreen -k key-seq [-e escape-seq] [-d device] 
[-t terminal type] 



Description 

The pscreen command sets up the terminal so that when a 
specified key is pressed on the keyboard, the contents of 
the screen will be printed on a printer connected to the 
auxiliary port on the terminal. Pscreen does not directly 
cause the screen to be printed on the printer; its only 
function is to set things up so that whenever the speci- 
fied key is pressed, the screen will be printed. 

The terminal that is being used must have an auxiliary 
port on it and it must accept an escape sequence that will 
cause the contents of the screen to be printed on a print- 
er connected to the auxiliary port. 

Some terminals such as the Altos V have a PRINT key that 
will automatically print the screen. If you are using 
such a terminal, it is not necessary to use pscreen. How- 
ever, other terminals such as the Altos II and Altos III 
do not have such a key, but they will accept an escape 
sequence to print the screen. On such terminals, it is 
suggested that a function key be reserved for the print 
screen key and that pscreen be used to define the sequence 
of characters that the function key sends to the computer 
when the key is pressed. 



Options 

-k Specifies the sequence of characters that the termi- 
nal sends to the computer when the print-screen key 
is pressed. The -k option must be specified. 
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-e Specifies the escape sequence that the computer 
should send to the terminal after the print-screen 
key is pressed. If not specified, then the string of 
characters specified in the termcap capability "SP" 
is used. 

-d Specifies the device name (e.g., /dev/tty04 or tty04). 
If not specified, the user's current port is used. 
Only the super-user can specify a device other than 
the current port. 

-t Specifies the terminal type (e.g., altos3). The ter- 
minal type must be one of the terminal types in the 
/etc/termcap file. 

If neither -t nor -d are specified, then the terminal type 
specified in the environment variable TERM is used. If -t 
is not specified but -d is specified, then the terminal 
type specified in /etc/ttytype for the specified device is 
used. 

Each character in the sequences specified by the -k and -e 
options can be either a single ASCII character, a hexa- 
decimal number (e.g., Oxlb), an octal number (e.g., 033), 
or an ASCII abbreviation (e.g., ESC or SOH). Alternative- 
ly, the character can be specified as a decimal number 
provided that it contains at least 2 digits. A single 
decimal digit (0 through 9) will be interpreted as a 
single ASCII character unless a trailing "d" (or "D") is 
appended (e.g., 9D). The character must have a non-zero 
value less than 0x80 (i.e., less than 128). 

The following list shows all the valid ASCII abbrevia- 
tions. Each abbreviation can be either uppercase or 
lowercase letters. 
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Abbreviation Hex Value Abbreviation Hex Value 





UXUl 


TNT T? 

DLh 


Oxiu 


STX 


UXU^ 


DCl 


0x11 


h 1 A 


UXOo 




Uxl2 


EOT 


0x04 


DC3 


0x13 


ENQ 


0x05 


DC4 


0x14 


ACK 


0x06 


NAK 


0x15 


BEL 


0x07 


SYN 


0x16 


BS 


0x08 


ETB 


0x17 


HT 


0x09 


CAN 


0x18 


IF 


OxOa 


EM 


0x19 


VT 


OxOb 


SUB 


Oxla 


FF 


OxOc 


ESC 


Oxlb 


CR 


Oxad 


FS 


Oxlc 


SO 


OxOe 


GS 


Oxld 


SI 


OxOf 


RS 


0x1 e 






US 


Oxlf 



Examples 

pscreen -k SOH j CR -e ESC [Oi -t altosS 

and 

pscreen -k 0x01 0x6a OxOd -e Oxlb 0x5b 0x69 -t altos3 

Both of these commands are identical. The shifted QQ 
key on the Altos III produces the "SOH j CR" sequence. Sc 
when that key is pressed, the screen will be printed on the 
printer. 



Notes 

Be careful about using the special shell characters in the 
command line for pscreen. For example, when using the C 
shell (csh), the above example should be ts^ped as follows: 

pscreen -k SOH j CR -e ESC i -t altosS 

because the left bracket is a special character. 
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If the printer is also configured as an auxiliary (trans- 
parent) printer using pconfig, it is not possible to print 
the screen while the printer is busy printing another 
file. 
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Name 

pwd - Prints the working directory name. 

Syntax 
pwd 

Description 

The pwd command prints the pathname of the working 
(current) directory. Using pwd, you can always check to 
see where you are in the system. 



Example 

The system responds that you are on machine xl in the 
WorkNet network in the directory /usr/chris. If your com- 
puter is not part of a network, the system response would 
be "/usr/chris" with no machine name. 

exl/ysr/chris 

See Also 
cd(C) 

Diagnostics 

"Cannot open ..." and "Read error in ..." indicate 
possible file system trouble; contact your system 
administrator. 
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Name 



quot - Summarizes file system ownership. 



Syntax 



quot [ option ] ... [ filesystem ] 



Description 

Quot prints the number of blocks in the named filesystem 
currently owned by each user. If no filesystem is named, 
the file systems given in /etc/mnttab are examined. 

The following options are available: 

-c Prints three columns giving file size in blocks, num- 
ber of files of that size, and cumulative total of 
blocks in that size or smaller file. Data for files 
of size greater than 499 blocks are included in the 
figures for files of exactly size 499. 

-f Prints count of number of files as well as space 
owned by each user. 

-n This option uses the output of the ncheck(C) command 
to produce a list of files and their owners, in the 
specified filesystem. For example: 



ncheck /dev/hdOb | sort +0n | quot -n /dev/hdOb 



will produce a listing of all files and their owners, 
on the root file system. 



Files 



/etc/passwd 
/etc/mnttab 



Gets user names 

Contains list of mounted file systems 
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See Also 

du(C), ls(C) 

Notes 

Holes in files are counted as if they actually occupied 
space. 
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Name 

random - Generates a random number. 

Synt£ix 

random [ -s ] [ scale ] 



Description 

Random generates a random number on the standard output, 
and returns the number as its exit value. By default, 
this number is either 0 or 1. If scale is given a value 
between 1 and 255, then the range of the random value is 
from 0 to scale. If scale is greater than 255 an error 
message is printed. 

-s Silent: returns the random number as an exit value 
but is not printed on the standard output. If an 
error occurs, random returns an exit value of zero. 



See Also 

rand(S) 



Notes 

This command does not perform any floating point computa- 
tions. Random uses the time of day as a seed. 
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Name 



reboot - Automatically reboots the system. 

Syntax 

/etc/reboot 

Description 

The reboot command, when used with the haltsys command, 
automatically reboots the system. 

To use reboot with the haltsys command, enter; 



/etc/reboot 
/etc/haltsys 




Related Commands 



haltsys(C), shutdown(M) 
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Name 

recover - Restores the contents of a file system from 
streaming tape to disk. 



Syntax 

recover [-i|-s|-v] mag_tape filejsystem 



Description 

This command can only be used by the super-user. 

The recover command copies the tape (specified by 
mag_tape) to the hard disk file system. Specify 
file_system as /dev/rhdlb for the second hard disk, or 
/dev/rhd2b for the third hard disk. 

Recover can only restore a tape that was backed up using 
the archive(C) command. To restore a tape created with 
the dump.hd(C) command, use restore.hd(C). 



Options 

-1 Displays the character string that was specified by 

the -i option on the archive command that created the 
tape. This option does not copy the contents of the 
tape to the hard disk; it only displays the character 
string. 

-s Displays information from the header block: the num- 
ber of the tape, the creation date, the starting 
block number on the tape, and the name of the file 
system. This option does not copy the contents of 
the tape to the hard disk. 

-V Verifies the checksums on the tape (makes sure the 
data was written correctly), without writing to the 
hard disk. 

When restoring the root file system on the hard disk 
(i.e., /dev/rhdOb), boot the system from the Root floppy 
disk, and select option "c" on the menu. The tape used by 
this procedure must have been created by the dump.hd(C) 
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command, or by the backup commands of the AOM menu 
system or Business shell. 

Be sure to specify /dev/rsct (for streaming tape) when 
using archive or recover. Do not use /dev/rct, because 
the tape will "stream" only with /dev/rsct. 



Examples 



For example, this command backs up the second hard disk to 
tape. 



/etc/umount /dev/hdlb 

archive -e /dev/rhdlb /dev/rsct 



Retn 



Retn 



This command restores the files on the archive tape to the 
second hard disk. 



/etc/umount /dev/hdlb 

recover /dev/rsct /dev/rhdlb 



Retn 



Retn 



To see the name of the device you want to back up, use: 
mount BtBBB 

The screen displays the device name, for example. 



Related Commiands 
archive(C) 

See Also 

Operations Guide 
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Name 

reset - Resets the teletype bits to soft-copy terminal 
standard mode. 



Syntax 

reset 



Description 

The reset command sets the teletype bits to a sensible 
state with the er ase char acter set to ■•HBBi» and the kill 
character set to mJBM . The reset command is most useful 
when a program that you are running in raw mode (terminal 
input is passed to a program one character at a time) 
fails. 

To reset your terminal using this com mand, yo u may have to 
type reset followed by a linefeed (or KWilBM if there is 
no linefeed). 



Related Commands 
stty(C) 
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Name 

restore. hd - Restores a hard disk from tape. 



Syntax 

restore.hd 



Description 

The restore.hd command restores the root file system from 
cartridge tape (made with dump.hd(C)) to the hard disk. 
To run restore.hd, boot the system from the Root floppy 
disk, then select option "C," Restore data to the hard 
disk from cartridge tape. To restore files from the 
second (third) hard disk, see recover(C). 



CAUTION 

Restore.hd overwrites ALL data on the hard 
disk and replaces it with the files from the 
cartridge tape. 



See Also 

archive(C), layout(C), recover(C), sizefs(C) 
OpeTations Guide 
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Name 

rev - Reverses lines of a file. 

Syntax 

rev [ file... ] 

Description 

Rev copies the named files to the standard output, revers- 
ing the order of characters in every line. If no file is 
specified, the standard input is copied. 

Notes 

There is a limit of 255 characters per line. 
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Name 

rm, raidir - Removes files or directories. 



Syntax 

rm [-f] [-1] file... 

rm -r [-f] [-i] diTname... [file...] 

rmdir [-p] [-s] dimame... 



Description 

Rm removes the entries for one or more files from a direc- 
tory. If an entry was the last link to the file, the file 
is destroyed. Removal of a file requires write permission 
in its directory, but neither read nor write permission on 
the file itself. 

If a file has no write permission and the standard input 
is a terminal, the full set of permissions (in octal) for 
the file are printed followed by a question mark. This is 
a prompt for confirmation. If the answer begins with y 
(for yes), the file is deleted, otherwise the file re- 
mains. 

Note that if the standard input is not a terminal, the 
command will operate as if the -f option is in effect. 

Rmdir removes the named directories, which must be empty. 

Three options apply to rm: 

-f This option causes the removal of all files (whether 
write-protected or not) in a directory without 
prompting the user. In a write-protected directory, 
however, files are never removed (whatever their per- 
missions are), but no messages are displayed. If the 
removal of a write-protected directory was attempted, 
this option cannot suppress an error message. 

-r This option causes the recursive removal of any di- 
rectories and subdirectories in the argument list. 
The directory will be emptied of files and removed. 
Note that the user is normally prompted for removal 
of any write-protected files which the directory con- 
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tains. The write-protected files are removed without 
prompting, however, if the -f option is used, or if 
the standard input is not a terminal and the -i op- 
tion is not used. 

) 

' If the removal of a non-empty, write-protected direc- 

tory was attempted, the command will always fail 
(even if the -f option is used), resulting in an 
error message. 

-i With this option, confirmation of removal of any 
write-protected file occurs interactively. It over- 
rides the -f option and remains in effect even if the 
standard input is not a terminal. 

Two options apply to rmdir: 

-p This option allows users to remove the directory 
dirname and its parent directories which become 
empty. A message is printed on standard output as 
to whether the whole path is removed or part of the 
path remains for some reason. 

') -s This option is used to suppress the message printed 

on standard error when -p is in effect. 



Diagnostics 

All messages are generally self-explanatory. It is for- 
bidden to remove the files "." and in order to avoid 
the consequences of inadvertently doing something like the 
following: 

rm -r .* 

Both rm and rmdir return exit codes of 0 if all the speci- 
fied directories are removed successfully. Otherwise, 
they return a non-zero exit code. 



See Also 

unlink(S), rmdir(S) in the Reference (CP, S, F) 
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Name 

rmail - Receives mail (from uucp link). 



Synopsis 

rmail to-path 
text 



Description 

This front-end mailer is only for systems with "execmail." 
It takes the first lines of a message from the standard 
input, and folds "From" lines to produce a single line 
with an accurate uucp(C) path, and pipes the mail through 
usr/lib/mail/execmail from-path to-path. 

Te xt is the text of the letter on the standard input until 
an ■wiBBiB (end-of-file). 



See Also 

uucp(C) 
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Name 



sar 



System activity reporter. 



Syntax 



sar [-aAbcCdDmpqrSuvwy] [-o file] tin] 

sar [-aAbcCdDmpqrSuvwy] [-s time] [-e time] [-i sec] 



Sar, in the first instance, samples cumulative activity 
counters in the operating system at n intervals of t 
seconds, where f should he 5 or greater. If the -o option 
is specified, it saves the samples in file in binary for- 
mat. The default value of n is 1. In the second in- 
stance, with no sampling interval specified, sar extracts 
data from a previously recorded file, either the one spe- 
cified by -f option or, by default, the standard system 
activity daily data file /usr/adm/sa/sadd for the current 
day dd. The starting and ending times of the report can 
be bounded via the -s and -e time arguments of the form 
hh[:mm[:ss]]. The -i option selects records at sec second 
intervals. Otherwise, all intervals found in the data 
file are reported. 

In either case, subsets of data to be printed are speci- 
fied by option: 

-a Report use of file access system routines: iget/s, 
namei/s, dirblk/s. 

-A Report all data. Equivalent to -aAbcCdDmpqrSuvwy 

-b Report buffer activity: 

bread/s, bwrit/s transfers per second of data 



[-f file] 



Description 



between system buffers and disk 
or other block devices 



Iread/s, Iwrit/s 



accesses of system buffers 



%rcache, %wcache 



cache hit ratios, i.e.. 
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-c 



%rcache, %wcache 
pread/s, pwrit/s 
pread/s, pwrit/s 



Report system calls: 
scall/s 



cache hit ratios, i.e., 
(1-bread/lread) as a percentage 

transfers via raw (physical) 
device mechanism 

transfers via raw (physical) 
device mechanism. When used 
with -D, buffer caching is re- 
ported for locally-mounted re- 
mote resources 



system calls of all tjTpes 



sread/s, swrit/s, fork/s, exec/s 

specific system calls 



rchar/s, wchar/s 



characters transferred by read 
and write system calls 



When used with -D, the system calls are split into 
incoming, outgoing, and strictly local calls. 

-C Report Remote File Sharing buffer caching overhead: 



snd-inv/s 

snd-msg/s 
rcv-inv/s 
rcv-msg/s 
dis-bread/s 



number of invalidation messages 
per second sent by your machine 
as a server 

total outgoing RFS messages sent 
per second 

number of invalidation messages 
received from the remote server 

total number of incoming RFS 
messages received per second 

number of buffer reads that woul 
be eligible for caching if cach- 
ing were not turned off (indi- 
cates the penalty of running 
unchached) 
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blk-inv/s 



number of buffers removed from 
the client cache. 



-d Report activity for each block device, e.g., disk or 
tape drive. When data is displayed, the device spe- 
cification dskis generally used to represent a disk 
drive. The device specification used to represent a 
tape drive is machine dependent. 

The activity data reported is: 

%busy, avque portion of time device was busy 



-D Report Remote File Sharing activity. When used in 
combination with -u or -c, it causes sar to produce 
the remote file sharing version of the corresponding 
report (-u is assumed when neither -u or -c is 
specified). 

-m Report message and semaphore activities: 
msg/s, sema/s primitives per second 

-p Report paging activities: 

vflt/s address translation page faults 



servicing a transfer request, 
average number of requests out- 
standing during that time 



r+w/s, blks/s 



number of data transfers from or 
to device, number of bytes trans- 
ferred in 512-byte units 



avwait, avserv 



average time in milliseconds that 
transfer requests wait idly on 
queue, and average time to be 
serviced (which for disks in- 
cludes seek, rotational latency 
and data transfer times) 



(valid page not in memory) 



pflt/s 



page faults from protection 
errors (illegal access to page) 
or "copy-on-writes" 
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pgfil/s vflt/s satisfied by page-in from 

file system 

rclm/s valid pages reclaimed for free 

list 

-q Report average queue length while occupied, and % of 
time occupied: 

runq-sz, %runocc run queue of processes in memory 
and runnable 

swpq-sz, %swpocc swap queue of processes swapped 
out but ready to run 

-r Report unused memory pages and disk blocks: 

freemem average pages available to user 

processes 

freeswap disk blocks available for process 

swapping 

-S Report server and request queue status: average num- 
ber of Remote File Sharing servers on the system 
(serv/lo- hi), % of time receive descriptors are on 
the request queue (request %busy), average number of 
receive descriptors waiting for service when queue is 
occupied (request avg Igth), % of time there are idle 
servers (server %avail), average number of idle 
servers when idle ones exist (server avg avail). 

-u Report CPU utilization (the default): 

%usr, %sys, %wio, %idle 

portion of time running in user 
mode, running in system mode, 
idle with some process waiting 
for block I/O, and otherwise 
idle. When used with -D, %sys 
is split into percent of time 
servicing requests from remote 
machines (%sys remote) and all 
other system time (%sys local) 
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-V Report status of process, i-node, file tables: 

text-sz, proc-sz, inod-sz, file-sz, lock-sz 

entries/size for each table, eval- 
uated once at sampling point; ov - 
overflows that occur between 
sampling points for each table 

-w Report system swapping and switching activity: 

swpin/s, swpot/s, bswin/s, bswot/s 

number of transfers and number 
of 512-byte units transferred for 
swapins and swapouts (including 
initial loading of some programs) 

pswch/s process switches 

-y Report TTY device activity: 

rawch/s, canch/s, outch/s 

input character rate, input 
character rate processed by 
canon, output character rate 

rcvin/s, xmtin/s, mdmin/s 

receive, transmit and modem 
interrupt rates. 



Examples 

To see today's CPU activity so far: 
sar 

To watch CPU activity evolve for 10 minutes and save data: 

sar -o temp 60 10 
To later review disk and tape activity from that period: 

sar -d -f temp 
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FUes 

/usr/adm/sa/sadd Daily data file, where dd are digits 
representing the day of the month. 

See Also 

sar(M) 
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Name 

script - Makes a record of your terminal session. 



Syntax 

script [ -a ] [ -q ] [ -S shell ] [ file ] 



Description 

Script makes a file of everything printed on your termi- 
nal. The typescript is saved in a file, and can be sent 
to the line printer later with Ipr(C). If a file name is 
given, the typescript is saved there. If not, the type- 
script is saved in the file named typescript. 

To exit script, type ■WiBBiB . This sends an end-of-file to 
all processes you have started up, and causes script to 
exit. For this reason, Ctrl-d behaves as though you had 
typed an infinite number of them. 

This program is useful when using a CRT and a hard-copy 
record of the dialog is desired, as for a student handing 
in a program that was developed on a CRT when hard-copy 
terminals are in short supply. 

The options are; 

-a Causes script to append to the tj^pescript file in- 
stead of creating a new file. 

-q Asks for "quiet mode", where the "script started" and 
"script done" messages are turned off. 

-S Lets you specify the shell; the default depends on 
the system. If the variable SHELL is set in the en- 
vironment, it is used if possible. 



Notes 

Since the operating system has no way to write an end of 
file down a pipe without closing the pipe, there is no way 
to simulate a single Ctrl-d without ending script. 
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The new shell has its standard input coming from a pipe 
rather than a tty, so stty(C) will not work, and neither 
will ttyname. In particular, this means that screen 
editors such as vi(C) are inoperative. 

When the user interrupts a printing process, script at- 
tempts to flush the output backed up in the pipe for 
better response. Usually the next prompt also gets 
flushed. 
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Name 

sdb - Symbolic debugger. 



Syntax 

sdb [-w] [-W] [objfile [corf He [directory-list]]] 



Description 

The sdb command calls a symbolic debugger that can be used 
with C programs. It may be used to examine object files 
and core files and to provide a controlled environment for 
program execution. 

Objfile is an executable program file which has been com- 
piled with the -g (debug) option. If it has not been com- 
piled with the -g option, the symbolic capabilities of sdb 
will be limited, but the file can still be examined and 
the program debugged. The default for objfile is a. out. 
Corfile is assumed to be a core image file produced after 
executing objfile; the default for corfile is core. The 
core file need not be present. A - in place of corfile 
will force sdb to ignore any core image file. The 
colon-separated list of directories (directory-list) is 
used to locate the source files used to build objfile. 

It is useful to know that at any time there is a current 
line and current file. If corfile exists then they are 
initially set to the line and file containing the source 
statement at which the process terminated. Otherwise, 
they are set to the first line in maini). The current 
line and file may be changed with the source file examina- 
tion commands. 

By default, warnings are provided if the source files used 
in producing objfile cannot be found, or are newer than 
objfile. This checking feature and the accompanying warn- 
ings may be disabled by the use of the -W flag. 

Names of variables are written just as they are in C. Sdb 
does not truncate names. Variables local to a procedure 
may be accessed using the form procedure:variable. If no 
procedure name is given, the procedure containing the cur- 
rent line is used by default. 
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You can also refer to structure members as 
variable. member, pointers to structure members as 
variable-ymember^ and array elements as variableinumber]. 
Pointers may be dereferenced by using the form point erlO], 
Combinations of these forms may also be used. A number 
may be used in place of a structure variable name, in 
which case the number is viewed as the address of the 
structure, and the template used for the structure is that 
of the last structure referenced by sdb. An unqualified 
structure variable may also be used with various commands. 
Generally, sdb will interpret a structure as a set of 
variables. Thus, sdb will display the values of all the 
elements of a structure when it is requested to display a 
structure. An exception to this interpretation occurs 
when displaying variable addresses. An entire structure 
does have an address, and it is this value sdb displays, 
not the addresses of individual elements. 

Elements of a multi-dimensional array may be referenced as 
variable [number] [number],.., or as variable 
[number, number,...]. In place of number, the form 
number;number may be used to indicate a range of values, 
* may be used to indicate all legitimate values for that 
subscript, or subscripts may be omitted entirely if they 
are the last subscripts and the full range of values is 
desired. As with structures, sdb displays all the values 
of an array or of the section of an array if trailing sub- 
scripts are omitted. 

A particular instance of a variable on the stack may be 
referenced by using the form proceduretvariable, number. 
All the variations mentioned in naming variables may be 
used. Number is the occurrence of the specified procedure 
on the stack, counting the top, or most current, as the 
first. If no procedure is specified, the procedure cur- 
rently executing is used by default. 

It is also possible to specify a variable by its address. 
All forms of integer constants that are valid in C may be 
used, so that addresses may be input in decimal, octal, or 
hexadecimal. 

Line numbers in the source program are referred to as 
file-name:number or proceduretnumber. In either case, the 
number is relative to the beginning of the file. If no 
procedure or file name is given, the current file is used 
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by default. If no number is given, the first line of the 
named procedure or file is used. 

While a process is running under sdb, all addresses refer 
\ to the executing program; otherwise they refer to objfile 

" or corfile. An initial argument of -w permits overwriting 

locations in objfile. In order to overwrite a location in 

obfilBy the process must not be running and a corefile 

must be present. 



Addresses 

The offset in a file associated with a virtual address is 
determined by a mapping associated with that file. Each 
mapping is represented by two triples (bi, eJ, fl) and 
(52, e2f f2), and the file offset corresponding to a vir- 
tual address is calculated as follows: 

51 <=address < el 

file address=address+fl-bl 

b2 <,=address < e2 

file address=address+f2-b2, 

or the requested address is not legal. In some cases 
(e.g., for programs with separated I and D space), the two 
segments for a file may overlap. 

The initial setting of both mappings is suitable for nor- 
mal a. out and core files. If either file is not of the 
kind expected for that file, 51 is set to 0, el is set to 
the maximum file size, and fl is set to 0; in this way, 
the whole file can be examined with no address transla- 
tion. 

In order for sdb to be used on large files, all appropri- 
ate values are kept as unsigned 32-bit integers. 
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Commands 

The commands for examining data in the program are: 

t Print a stack trace of the terminated or halted pro- 
gram. 

T Print the top line of the stack trace. 



variable/clm 

Print the value of variable according to length I and 
format m. A numeric count c indicates that a region 
of memory, beginning at the address implied by vari- 
ablCf is to be displayed. The length specifiers are: 

b one byte 

h two bytes (half word) 

1 four bytes (long word) 

Legal values for m are: 

c character 

d decimal 

u decimal, unsigned 

o octal 

X hexadecimal 

f 32-bit single precision floating point 

g 64-bit double precision floating point 

s Assume variable is a string pointer and 
print characters starting at the address 
pointed to by the variable. 

a Print characters starting at the variable's 
address. This format may not be used with 
register variables. 

p pointer to procedure 
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i 



Disassemble machine-language instruction 
with addresses printed numerically and 
symbolically. 



I 



Disassemble machine-language instruction 
with addresses just printed numerically. 



Length specifiers are only effective with the c, d, 
u, o and x formats. Any of the specifiers, c, 1, and 
m, may be omitted. If all are omitted, sdb chooses a 
length and a format suitable for the variable's type 
as declared in the program. If m is ^ecified, then 
this format is used for displaying the variable. A 
length specifier determines the output length of the 
value to be displayed, sometimes resulting in trunca- 
tion. A count specifier c tells sdb to display that 
many units of memory, beginning at the address of 
variable. The number of bytes in one such unit of 
memory is determined by the length specifier I, or if 
no length is given, by the size associated with the 
variable. If a count specifier is used for the s or 
a conunand, then that many characters are printed. 
Otherwise successive characters are printed until 
either a null byte is reached or 128 characters are 
printed. The last variable may be redisplayed with 
the command ./. 

The sh(C) metacharacters * and ? may be used within 
procedure and variable names, providing a limited 
form of pattern matching. If no procedure name is 
given, variables local to the current procedure and 
global variables are matched; if a procedure name is 
specified then only variables local to that procedure 
are matched. To match only global variables, the 
form '.pattern is used. 

Iinenumber7lm 
variable:?lm 

Print the value at the address from a.out or I space 
given by linenumber or variable (procedure name), 
according to the format Im. The default format is 
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vanable=lTn 

Unenumber=lm 

number=lm 

Print the address of variable or linenumberf or the 
value of number, in the format specified by Im. If 
no format is given, then Ix is used. The last vari- 
ant of this command provides a convenient way to con- 
vert between decimal, octal, and hexadecimal. 

variablelvalue 

Set variable to the given value. The value may be a 
number, a character constant or a variable. The 
value must be well defined; expressions which produce 
more than one value, such as structures, are not al- 
lowed. Character constants are denoted 'character. 
Numbers are viewed as integers unless a decimal point 
or exponent is used. In this case, they are treated 
as having the type double. Registers are viewed as 
integers. The variable may be an expression which 
indicates more than one variable, such as an array or 
structure name. If the address of a variable is 
given, it is regarded as the address of a variable of 
type int. C conventions are used in any type conver- 
sions necessary to perform the indicated assignment. 

X Print the machine registers and the current 
machine-language instruction. 

X Print the current machine-language instruction. 

The commands for examining source files are: 

e procedure 

e filename 

e directory/ 

e directory filename 

The first two forms set the current file to the file con- 
taining procedure or to filename. The current line is set 
to the first line in the named procedure or file. Source 
files are assumed to be in directory. The default is the 
current working directory. The latter two forms change 
the value of directory. If no procedure, filename, or 
directory is given, the current procedure name and file- 
name are reported. 
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/regular expression/ 

Search forward from the current line for a line con- 
taining a string matching regular expression as in 
e<J(C). The trailing / may be deleted. 

"^regular expression'! 

Search backward from the current line for a line con- 
taining a string matching regular expression as in 
ed(C). The trailing ? may be deleted. 

p Print the current line. 

z Print the current line followed by the next 9 
lines. Set the current line to the last line 
printed. 

w Window. Print the 10 lines around the current 
line. 

number 

Set the current line to the given line number. Print 
the new current line. 

count* 

Advance the current line by count lines. Print the 
new current line. 

count- 
Retreat the current line by count lines. Print the 
new current line. 

The commands for controlling the execution of the source 
program are: 

count r args 
count R 

Run the program with the given arguments. The r com- 
mand with no arguments reuses the previous arguments 
to the program while the R command runs the program 
with no arguments. An argument beginning with < or > 
causes redirection for the standard input or output, 
respectively. If count is given, it specifies the 
number of breakpoints to be ignored. 
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Unenumber c count 

Unemmber C count 

Continue after a breakpoint or interrupt. If count 
is given, the program will stop when count break- 
points have been encountered. The signal which 
caused the program to stop is reactivated with the C 
command and ignored with the c command. If a line 
number is specified then a temporary breakpoint is 
placed at the line and execution is continued. The 
breakpoint is deleted when the command finishes. 

Unenumber g count 

Continue after a breakpoint with execution resumed at 
the given line. If count is given, it specifies the 
number of breakpoints to be ignored. 

s count 
S count 

Single step the program through count lines. If no 
count is given then the program is run for one line. 
S is equivalent to s except it steps through proce- 
dure calls. 

i 

I Single step by one machine-language instruction. The 
signal which caused the program to stop is reacti- 
vated with the I command and ignored with the i com- 
mand. 

variable$m count 

addresstm count 

Single step (as with s) until the specified location 
is modified with a new value or count instructions 
have been executed. If count is omitted, it is ef- 
fectively infinity. Variable must be accessible from 
the current procedure. Since this command is done by 
software, it can be very slow. 

level V 

Toggle verbose mode, for use when single stepping 
with S, s or m. If level is omitted, then just the 
current source file and/or subroutine name is printed 
when either changes. If level is 1 or greater, each 
C source line is printed before it is executed; if 
level is 2 or greater, each assembler statement is 
also printed. A v turns verbose mode off if it is on 
for any level. 
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k Kill the program being debugged. 

procedure{arglyaTg2,...) 

procedure{argl^arg2,...)/m 

Execute the named procedure with the given arguments. 
Arguments can be integer, character or string con- 
stants or names of variables accessible from the cur- 
rent procedure. The second form causes the value 
returned by the procedure to be printed according to 
format m. If no format is given, it defaults to d. 
This facility is only available if the program was 
loaded with the -g option. 

linenumber b commands 

Set a breakpoint at the given line. If a procedure 
name without a line number is given (e.g., "proc:"), 
a breakpoint is placed at the first line in the pro- 
cedure even if it was not compiled with the -g op- 
tion. If no linenumber is given, a breakpoint is 
placed at the current line. If no commands are 
given, execution stops just before the breakpoint and 
control is returned to sdb. Otherwise the commands 
are executed when the breakpoint is encountered and 
execution continues. Multiple commands are specified 
by separating them with semicolons. If k is used as 
a command to execute at a breakpoint, control returns 
to sdb, instead of continuing execution. 

B Print a list of the currently active breakpoints. 

linenumber d 

Delete a breakpoint at the given line. If no line- 
number is given then the breakpoints are deleted in- 
teractively. Each breakpoint location is printed and 
a line is read from the standard input. If the line 
begins with a y or d then the breakpoint is deleted. 

D Delete all breakpoints. 

1 Print the last executed line. 

linenumber a 

Announce. If linenumber is of the form procinumber, 
the command effectively does a linenumber b 1. If 
linenumber is of the form proc:, the command effec- 
tively does a proc: b T. 
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Miscellaneous commands: 
Icommand 

The command is interpreted by sh(C). 
newline 

If the previous command printed a source line, then 
advance the current line by one line and print the 
new current line. If the previous command displayed 
a memory location, then display the next memory loca- 
tion. 

end-of-file character 

Scroll. Print the next 10 lines of instructions, 
source or data depending on which was printed last. 
The end-of-file character is usually control-d. 

< filename 

Read commands from filename until the end of file is 
reached, and then continue to accept conunands from 
standard input. When sdb is told to display a vari- 
able by a command in such a file, the variable name 
is displayed along with the value. This command may 
not be nested; < may not appear as a command in a 
file. 

M Print the address maps. 

M [?/] [*]b e f 

Record new values for the address map. The argument! 
? and / specify the text and data maps, respec- 
tively. The first segment (bl, cl, fl) is changed 
unless * is specified, in which case the second seg- 
ment (52, e2f f2) of the mapping is changed. If 
fewer than three values are given, the remaining map 
parameters are left unchanged. 

" string 

Print the given string. The C escape sequences of 
the form \character are recognized, where character 
is a nonnumeric character. 

q Exit the debugger. 
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The following commands also exist and are intended only 
for debugging the debugger: 

V Print the version number. 

Q Print a list of procedures and files being 
debugged. 

Y Toggle debug output. 



Files 

a. out 
core 



See Also 

cc(C), a.out(F), core(F), sh(C) 



Notes 

When sdb prints the value of an external variable for 
which there is no debugging information, a warning is 
printed before the value. The size is assumed to be int 
(integer). 

Data which are stored in text sections are indistinguish- 
able from functions. 

Line number information in optimized functions is unreli- 
able, and some information may be missing. 

If a procedure is called when the program is not stopped 
at a breakpoint (such as when a core image is being 
debugged), all variables are initialized before the proce- 
dure is started. This makes it impossible to use a proce- 
dure which formats data from a core image. 



11 



SDIFF(C) 



SDIFF(C) 



Name 

sdiff - Compares files side-by-side. 



Syntax 

sdiff [ options ] filel file2 



Description 

Sdiff uses the output of diff(C) to produce a side-by-side 
listing of two files indicating the lines that are differ- 
ent. The lines of the two files are printed with a blank 
gutter between them if they are identical; a < is put in 
the gutter if the line only exists in filely a > is put in 
the gutter if the line only exists in /ile2, and a | is 
put in the gutter for lines that are different. 

For example: 



X I y 

b < 
c < 
d d 

> <f 



The following options exist: 

-1 Only prints the left side of any lines that are 

identical. 

-o output Uses the next argument, output ^ as the name of 
a third file created by merging filel with 
file2. Identical lines of filel and file2 are 
copied to output. Sets of differences, as pro- 
duced by diff(C), are printed; sets of differ- 
ences share a common gutter character. After 
printing each set of differences, sdiff prompts 
the user with a % and waits for one of the fol- 
lowing commands: 
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e Calls the editor with a zero length file 

6 1 Calls the editor with the left column 

e r Calls the editor with the right column 

6 b Calls the editor with the concatenation of 
left and right 

1 Appends the left column to the output file 

q Exits from the program 

r Appends the right column to the output 
file 

s Turns on silent mode; does not print 
identical lines 

V Turns off silent mode 

-s Does not print identical lines. 

-w n Uses the next argument, n, as the width of the output 
line. The default line length is 130 characters. 

Upon exiting from the editor, the resulting file is con- 
catenated onto the end of the output file. 

See Also 

diff(C), ed(C) 
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Name 

sed - Invokes a stream editor. 



Sjmtax 

sed [ -n ] [ -e script ] [ -f sfile ] [ file ... ] 



Description 

Sed copies the named files (standard input default) to the 
standard output, edited according to a script of commands. 
The -f option causes the script to be taken from file 
sfile; these options accumulate. If there is just one -e 
option and no -f options, the flag -e may be omitted. The 
-n option suppresses the default output. A script con- 
sists of editing commands, one per line, of the following 
form: 

[ address [, address ] ] function [ arguments ] 

In normal operation, sed cyclically copies a line of input 
into a pattern space (unless there is something left after 
a D command), applies in sequence all commands whose ad- 
dresses select that pattern space, and at the end of the 
script copies the pattern space to the standard output 
(except under -n) and deletes the pattern space. 

Some of the commands use a hold space to save all or part 
of the pattern space for subsequent retrieval. An address 
is either a decimal number that counts input lines cumu- 
latively across files, a $ that addresses the last line of 
input, or a context address, i.e., a /regular expression/ 
in the style of ed(C) modified thus: 

• In a context address, the construction \?regular ex- 
pression?^ where ? is any character, is identical to 
/regular expression/. Note that in the context ad- 
dress \xabc\xdefx, the second x stands for itself, so 
that the regular expression is abcxdef. 

• The escape sequence \n matches a new-line embedded 
the pattern space. 
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A period . matches any character except the terminal 
newline of the pattern space. 

A command line with no addresses selects every pat- 
tern space. 



• A command line with one address selects each pattern 
space that matches the address. 

• A command line with two addresses selects the inclu- 
sive range from the first pattern space that matches 
the first address through the next pattern space that 
matches the second. (If the second address is a num- 
ber less than or equal to the line number first se- 
lected, only one line is selected.) 

Thereafter the process is repeated, looking again for the 
first address. 

Editing commands can be applied only to non-selected pat- 
tern spaces by use of the negation function ! (below). 

In the following list of functions, the maximum number of 
permissible addresses for each function is indicated in 
parentheses. 

The text argument consists of one or more lines, all but 
the last of which end with \ to hide the new-line. Back- 
slashes in text are treated like backslashes in the re- 
placement string of an s command, and may be used to pro- 
tect initial blanks and tabs against the stripping that is 
done on every script line. The rfile or wfile argument 
must terminate the command line and must be preceded by 
exactly one blank. Each wfile is created before proces- 
sing begins. There can be at most 10 distinct wfile argu- 
ments. 



(l)a\ 
text 



Append. Place text on the output before 
reading the next input line. 



{2)h_label 



Branch to the : command bearing the label. 
If label is empty, branch to the end of the 
script. 
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(2)C\ 

text Change. Delete the pattern space. With 0 

or 1 address or at the end of a 2-address 
range, place text on the output. Start the 
next cycle. 

(2)d Delete the pattern space. Start the next 

cycle. 

(2)D Delete the initial segment of the pattern 

space through the first new-line. Start 
the next cycle. 

(2)g Replace the contents of the pattern space 

by the contents of the hold space. 

(2)G Append the contents of the hold space to 

the pattern space. 

(2)h Replace the contents of the hold space by 

the contents of the pattern space. 

(2)H Append the contents of the pattern space to 

the hold space. 

(1) i\ text Insert. Place text on the standard output. 

(2) 1 List the pattern space on the standard out- 

put in an unambiguous form. Non-printing 
characters are spelled in two-digit ASCII 
and long lines are folded. 

(2)n Copy the pattern space to the standard out- 

put. Replace the pattern space with the 
next line of input. 

(2)N Append the next line of input to the pat- 

tern space with an embedded new-line. 
(The current line number changes.) 

(2)p Print. Copy the pattern space to the stan- 

dard output. 

(2)P Copy the initial segment of the pattern 

space through the first new-line to the 
standard output. 
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(1) q Quit. Branch to the end of the script. Do 

not start a new cycle. 

(2) r rfile Read the contents of rfile. Place them on 
I) the output before reading the next input 

^ line. 

{2)s/regular expression/replacement/flags 

Substitute the replacement string for in- 
stances of the regular expression in the 
pattern space. Any character may be used 
instead of /. for a fuller description see 
ed(C). Flags is zero or more of: 

n n=l-512. Substitute for just 

the nth occurrence of the regular 
expression. 

g Global. Substitute for all non- 

overlapping instances of the reg- 
ular expression rather than just 
the first one. 

) p Print the pattern space if a re- 

placement was made. 

w wfile Write. Append the pattern space 
to wfile if a replacement was 
made. 

(2)t label Test. Branch to the : command bearing 

the label if any substitutions have been 
made since the most recent reading of an 
input line or execution of a t. If label 
is empty, branch to the end of the script. 

(2)w wfile Write. Append the pattern space to wfile. 

(2)x Exchange the contents of the pattern and 

hold spaces. 

i2)y/ string 1/ string2/ 
\ Transform. Replace all occurrences of 

characters in stringl with the correspond- 
ing character in string2. The lengths of 
stringl and string2 must be equal. 
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(2)1 function Don't. Apply the function (or group, if 
function is {) only to lines not selected 
by the address (es). 

(Oy.label This command does nothing; it bears a label 

for b and t commands to branch to. 

(1) = Place the current line number on the stan- 

dard output as a line. 

(2) { Execute the following commands through a 

matching } only when the pattern space is 
selected. 

(0) An empty command is ignored. 

(0)# If a # appears as the first character on 

the first line of a script file, then that 
entire line is treated as a comment, with 
one exception. If the character after the 
# is an 'n', then the default output will 
be suppressed. The rest of the line after 
#n is also ignored. A script file must 
contain at least one non-comment line. 



See Also 

awk(C), ed(C), grep(C) 
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Name 

see - Displays a file 

Syntax 

see [ - ] [ file... ] 



Description 

See lists a file, displaying non-printing characters in 
visible f ormat. Control characters show as ""X" for 
|32SBi> where x is any letter. Tab prints as ""I." De- 
lete prints as ""?." Ends of lines are marked with "$" 
unless the "-" option is given. 



See Also 

cat(C), ex(C) 
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Name 

setmnt - Establishes /etc/mnttab table. 



Syntax 

/etc/setmnt 



Description 

The setmnt command is usually executed by the system and 
creates and updates the /etc/mnttab table, which is needed 
for both the mount(C) and umount(C) commands. Setmnt 
reads the standard input and creates a mnttab entry for 
each line. Input lines have the format: 

filesys node 

where filesys is the name of the file system's special 
file (for example, /dev/hdOb) and node is the root name of 
that file system. Thus filesys and node become the first 
two strings in the mnttab entry. 



Files 

/etc/mnttab 



See Also 

mount(C) 



Notes 

Problems may occur if filesys or node are longer than 32 
characters. Setmnt silently enforces an upper limit on 
the maximum number of mnttab entries. 
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Name 

setmode - Port modes utility. 



Syntax 

setmode device mode ... 



Description 

Setmode sets tty modes (see tty(M)) for tty ports that 
are used for serial devices. Use this program to set 
baud rate, tab expansion, and newline actions for pro- 
grams that communicated directly through a serial port. 

Setmode takes a list of tty modes from its command line, 
does an stty(C) on the indicated device, and sleeps for- 
ever, which keeps the device open with the desired modes. 
Invoke setmode once for each port device. 

To ensure that setmode is run every time the system en- 
ters multi-user mode, invoke setmode in the /ete/inittab 
file. 

You must invoke setmode with at least two arguments: the 
name of the device (special file) and at least one tty 
mode. 



Files 

/dev/tty* tty devices 

/etc/inittab 



Related Commands 

disable(C), enable(C), pconfig(C), stty(C), xtty(C), 
inittab(M) 



See Also 

tty(M) 
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Name 

setmodem - Sets and unsets a tty port to be used with a 
modem. 



Syntax 

/etc/setmodem mode ttynn 



Description 

This command can only be accessed by the super user. 

Use the setmodem conmiand to set up a device (/dev/ttynn) 
for use with a modem. The letters nn stand for a one or 
two-digit device number, for example, tty05. Execute this 
command every time the system is booted for every port 
that has a modem attached. 

The setmodem command ensures that a dial-up tty will be 
logged out when a telephone connection is terminated. 



Options 

Mode is either on, off, or user. 

on Sets clocal to OFF, and hupcl to ON. This 
flag cannot be changed without issuing another 
setmodem command. 

off Sets clocal to ON, and hupcl to OFF. This flag 
cannot be changed without issuing another 
setmodem command. 

user is as follows: 

If the clocal flag is not set, a high- to-low 
signal on pin 6 causes a hang up; a low-to-high 
signal allows login to occur. 

If the hupcl flag is set, the system sends a 
hangup signal when the last file connected to 
that terminal is closed. 

You can change modes with the stty(C) command. 
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Examples 

These commands are equivalent and tell the system that a 
modem is being used on serial port 5. 

/etc/setmodem on /dev/tty05 
/etc/setmodem on tty05 



Related Commands 

disable(C), tty(C), enable(C), getty(M), login{C), 
pconfig(C) 
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Name 

setpgrp - Executes a command in a new process group. 



Syntax 

setpgrp command [arg ...] 



Description 

This command creates a new process group to execute the 
specified command. It also removes the controlling tty 
from the new process group. Setpgrp can be useful for 
detaching conmiands that are run in the background from the 
parent shell process. 



Diagnostics 

Setpgrp returns an exit code of 1 if the command cannot be 
executed. Otherwise, the exit code is that returned by 
the command. 



See Also 

exec(S), setpgrp(S) in the Reference CCP, S, F) 
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Name 



settime - Changes the access and modification dates of 
files. 



Syntax 

settime [ mmddhhmm ] [ yy ] [ -f sfile ] file ... 



Description 

This command sets the access and modification dates for 
one or more files. The dates are set to the specified 
date. 

-f Sets file to the access and modification dates of 
sfile. 

Use one of these methods to specify the new date. The 
first mm is the month number; dd is the day number in the 
month; hh is the hour number (24 hour system); the second 
mm is the minute number; yy is the last two digits of the 
year and is optional. For example: 

settime 1008004586 ralph pete 

sets the access and modification dates of files named 

ralph and pete to Oct 8, 12:45 AM, 1986. Another example: 

settime -f ralph john 

This sets the access and modification dates of the file 
named john to those of the file named ralph. 



See Also 

touch(C) 
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Name 

sh, rsh - Shell, the standard/restricted command program- 
ming language. 



Syntax 

sh [ -acefhiknrstuvx ] [ orgs ] 
rsh [ -acefhiknrstuvx ] [ args ] 



Description 

Sh is a command programming language that executes com- 
mands read from a terminal or a file. Rsh is a restricted 
version of the standard command interprepter sh; it is 
used to set up login names and execution environments 
whose capabilities are more controlled than those of the 
standard shell. See "Invocation" that follows for the 
meaning of arguments to the shell. 



Definitions 

A blank is a tab or a space. A name is a sequence of 
letters, digits, or underscores beginning with a letter or 
underscore. A parameter is a name, a digit, or any of the 
characters *, @, #, ?, -, $, and I. 



Commands 

A simple shell command is a sequence of words separated by 
blanks (a blank is a tab or a space). The first word spe- 
cifies the name of the command to be executed. Except as 
specified below, the remaining words are passed as argu- 
ments to the invoked command. The command name is 
passed as argument 0. The value of a simple command is 
its exit status if it terminates normally, or (octal) 200+ 
status if it terminates abnormally, i.e., if the failure 
produces a core file. 

A pipeline is a sequence of one or more commands separatee 
by a vertical bar (|). The caret (") also has the same 
effect. The standard output of each command but the last 
is connected by a pipe to the standard input of the next 
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command. Each command is run as a separate process; the 
shell waits for the last command to terminate. 

A list is a sequence of one or more pipelines separated by 
;, &, &&, or I I and optionally terminated by ; or &. Of 
these symbols, ; and & have equal precedence, which is 
lower than that of && and | | . The symbols && and | | 
also have equal precedence. A semicolon (;) causes se- 
quential execution of the preceding pipeline; an ampersand 
(&) causes asjmchronous execution of the preceding pipe- 
line (i.e., the shell does not wait for that pipeline to 
finish). The symbol && ( | | ) causes the list following it 
to be executed only if the preceding pipeline returns a 
zero (nonzero) exit status. An arbitrary number of new- 
lines may appear in a list, instead of semicolons, to de- 
limit commands. 

A command is either a simple-command or one of the follow- 
ing. Unless otherwise stated, the value returned by a 
command is that of the last simple-command executed in the 
command. 

for name [in word ... ] do list done 

Each time a for command is executed, name is set to 
the next word taken from the in word list. If in 
word is omitted, the for command executes the do list 
once for each positional parameter that is set (see 
"Parameter Substitution" below). Execution ends when 
there are no more words in the list. 

case word in [pattern [\pattern] ...) list ;;] ... esac 

A case command executes the list associated with the 
first pattern that matches word. The form of the 
patterns is the same as that used for file name gen- 
eration (see "File Name Generation" below) except 
that a slash, leading dot, or dot immediately follow- 
ing a slash need not be matched explicitly. 

if list then list [elif list then list] ... [else list] fi 

The list following If is executed and, if it returns 
a zero exit status; the list following the first then 
is executed. Otherwise, the list following elif is 
executed. If its value is zero, the list following 
the next then is executed. Failing that, the else 
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list is executed. If no else list or then list is 
executed, the if command returns a zero exit status. 

while list do list done 

A while command repeatedly executes the while list 
and, if the exit status of the last command in the 
list is zero, executes the do list; otherwise the 
loop terminates. If no commands in the do list are 
executed, then the while command returns a zero exit 
status. You can use until in place of while to ne- 
gate the loop termination test. 

Hist) 

Executes h'st in a subshell. 

{list;} 

List is executed in the current (that is, parent) 
shell. 

name () {list; } 

Define a function which is referenced by name. The 
body of the function is the h'st of commands between 
{ and }. Execution of functions is described below 
(see "Execution"). The curly brace (}) must be on a 
line by itself, or preceded by a semicolon (;) or 
followed by a delimiter. 

Use type name to display the commands executed by 
name. 

The following words are only recognized as the first word 
of a command and when not quoted (not preceded by a bad 
slash (\)): 

if then else elif fi case esac for while until do 
done { } 



Comments 

A word beginning with # causes that word and all the fol- 
lowing characters up to a newline to be ignored. 
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Command Substitution 

The standard output from a command enclosed in a pair of 
grave accents ( * " ) can be used as part or all of a word; 
trailing newlines from the standard output are removed. 
No interpretation is done on the string before it is read, 
except to remove backslashes (\) used to escape other 
characters. Backslashes may be used to escape a grave 
accent (') or another backslash (\) and are removed before 
the command string is read. Escaping grave accents allows 
nested command substitution. If the command substitution 
lies within a pair of double quotes ("... \.. \.."), a 
backslash used to escape a double quote (\") will be re- 
moved; otherwise, it will be left intact. 

If a backslash is used to escape a new-line character 
(\new-line), both the backslash and the new-line are re- 
moved (see the later section on "Quoting"). In addition, 
backslashes used to escape dollar signs (\$) are removed. 
Since no interpretation is done on the command string be- 
fore it is read, inserting a backslash to escape a dollar 
sign has no effect. Backslahses that precede characters 
other than \,%", new-line, and $ are left intact when the 
command string is read. 



Parameter Substitution 

The character $ is used to introduce substitutable param- 
eters. There are two types of parameters, positional and 
keyword. If parameter is a digit, it is a positional pa- 
rameter. Positional parameters may be assigned values by 
set. KejAvord parameters (also known as variables) may be 
assigned values by writing: 

name=value [ name^^value ] ... 

Pattern-matching is not performed on value. There cannot 
be a function and a variable with the same name. 
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${parameter} 

A parameter is a sequence of letters, digits, or un- 
derscores (a name), a digit, or any of the characters 
*♦ @, #, ?♦ -, $» and I. The value, if any, of the 
parameter is substituted. The braces are required 
only when parameter is followed by a letter, digit, 
or underscore that is not to be interpreted as part 
of its name. A name must begin with a letter or un- 
derscore. If parameter is a digit, it is a posi- 
tional parameter. If parameter is * or @, all the 
positional parameters, starting with $1, are substi- 
tuted (separated by spaces). Parameter $0 is set 
from argument zero when the shell is invoked. 

%{parameter:-word} 

If parameter is set and is non-null, substitute its 
value; otherwise, substitute word. 

${parameter:==word} 

If parameter is not set or is null, set it to word; 
the value of the parameter is then substituted. Po- 
sitional parameters may not be assigned in this way. 

${parameter:?word} 

If parameter is set and is non-null, substitute its 
value; otherwise, print word and exit from the shell. 
If word is omitted, the message "parameter null or 
not set" is printed. 

^{parameteri+word} 

If parameter is set and is non-null, substitute word; 
otherwise, substitute nothing. 

In the above, word is not evaluated unless it is to be 
used as the substituted string. In the following example, 
pwd is executed only if d is not set or is null: 

echo ${d:- *pwd'} 

If the colon (:) is omitted from the above expressions, 
the shell only checks whether parameter is set. 
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Command Substitution 

The standard output from a command enclosed in a pair of 
grave accents ( * * ) can be used as part or all of a word; 
) trailing newlines from the standard output are removed. 

No interpretation is done on the string before it is read, 
except to remove backslashes (\) used to escape other 
characters. Backslashes may be used to escape a grave 
accent (*) or another backslash (\) and are removed before 
the command string is read. Escaping grave accents allows 
nested command substitution. If the command substitution 
lies within a pair of double quotes ("... \.. \.."), a 
backslash used to escape a double quote (\") will be re- 
moved; otherwise, it will be left intact. 

If a backslash is used to escape a new-line character 
(\new-line), both the backslash and the new-line are re- 
moved (see the later section on "Quoting"). In addition, 
backslashes used to escape dollar signs (\$) are removed. 
Since no interpretation is done on the command string be- 
fore it is read, inserting a backslash to escape a dollar 
sign has no effect. Backslahses that precede characters 
other than \,",", new-line, and $ are left intact when the 
command string is read. 



Parameter Substitution 

The character $ is used to introduce substitutable param- 
eters. There are two types of parameters, positional and 
ke5rword. If parameter is a digit, it is a positional pa- 
rameter. Positional parameters may be assigned values by 
set. Keyword parameters (also known as variables) may be 
assigned values by writing: 

name=value [ name=value ] ... 

Pattern-matching is not performed on value. There cannot 
be a function and a variable with the same name. 
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${parameter} 

A parameter is a sequence of letters, digits, or un- 
derscores (a name), a digit, or any of the characters 
*, @. #, ?, -, $, and I. The value, if any, of the 
parameter is substituted. The braces are required 
only when parameter is followed by a letter, digit, 
or underscore that is not to be interpreted as part 
of its name. A name must begin with a letter or un- 
derscore. If parameter is a digit, it is a posi- 
tional parameter. If parameter is * or @, all the 
positional parameters, starting with $1, are substi- 
tuted (separated by spaces). Parameter $0 is set 
from argument zero when the shell is invoked. 

${parameter'.-word} 

If parameter is set and is non-null, substitute its 
value; otherwise, substitute word. 

${parameter:"Word} 

If parameter is not set or is null, set it to word; 
the value of the parameter is then substituted. Po- 
sitional parameters may not be assigned in this way. 

${parameter:'2word} 

If parameter is set and is non-null, substitute its 
value; otherwise, print word and exit from the shell. 
If word is omitted, the message "parameter null or 
not set" is printed. 

${parameter:*word} 

If parameter is set and is non-null, substitute word; 
otherwise, substitute nothing. 

In the above, word is not evaluated unless it is to be 
used as the substituted string. In the following example, 
pwd is executed only if d is not set or is null; 

echo ${d:- *pwd*} 

If the colon (:) is omitted from the above expressions, 
the shell only checks whether parameter is set. 
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Shell Parameters 



The following parameters are automatically set by the 
shell: 

# The number of positional parameters in decimal. 

Flags supplied to the shell on invocation or by the 
set command. 



The decimal value returned by the last synchronously 
executed command. 



$ The process number of this shell. 



The process number of the last background command 
invoked. 



The following parameters are used by the shell: 

HOME The default argument (home directory) for 

the cd command. 



PATH 



The search path for commands (see 
"Execution" below). The user may not 
change PATH if executing from rsh. 



MAIL 



If this is set to the name of a mail file 
and MAILPATH is not set, then the shell 
informs the user of the arrival of mail in 
the specified file. 



CDPATH 



The search path for the cd command. 



MAILCHECK This parameter specifies how often (in 

seconds) the shell will check for the ar- 
rival of mail in the files specified by the 
MAILPATH or MAIL parameters. The de- 
fault value is 600 seconds (10 minutes). 
If set to 0, the shell will check before 
each prompt. 
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MAILPATH A colon (:) separated list of file names. 

If this parameter is set, the shell informs 
the user of the arrival of mail in any of 
the specified files. Each file name can be 
followed by % and a message that will be 
printed when the modification time changes. 
The default message is "You have mail." 

Primary prompt string, by default "$". 

Secondary prompt string, by default ">". 

Internal field separators, normally space, 
tab, and new-line. 

If this parameter is set to the name of a 
file writable by the user, the shell will 
write an accounting record in the file for 
each shell procedure executed. SHACCT 
must be exported for this to work. 

When the shell is invoked, it scans the 
enviroment (see "Environment" that follows) 
for this name. If it is found and 'rsh' is 
the file name part of its value, the shell 
becomes a restricted shell. 

The shell gives default values to PATH, PSl, PS2, 
MAILCHECK and IPS, while HOME and MAIL are set by 
login(C). 



Blank Interpretation 

After parameter and command substitution, the results of 
substitution are scanned for internal field separator 
characters (those found in IPS). When such characters are 
found, they are split into distinct arguments. Explicit 
null arguments are retained. Implicit null arguments 
(those resulting from parameters that have no values) are 
removed. 



PSl 
PS2 
IPS 

SHACCT 
SHELL 
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Input/Output 



Before a command is executed, its input and output can be 
redirected using a special notation interpreted by the 
^ shell. The following character strings may appear any- 

*' where in a simple command or may precede or follow a com- 

mand. These character strings are not passed on to the 
invoked command; substitution occurs before word or digit 
is used: 



<word Use file word as standard input (file de- 

scriptor 0). 

>word Use file word as standard output (file de- 

scriptor 1). If the file does not exist 
then it is created; otherwise, it is trun- 
cated to zero length. 

»word Use file word as standard output. If the 

file exists then output is appended to it 
(by first seeking to the end-of-file); 
otherwise, the file is created. 

«[--]word After parameter and command substitution is 
done on wordy the shell input is read up to 
the first line that literally matches the 
resulting word, or to an end-of-file. If, 
however, — is appended to «: 



1) leading tabs are stripped from word 
before the shell input is read (but 
after parameter and command substitu- 
tion is done on word), 



2) leading tabs are stripped from the 
shell input as it is read and before 
each line is compared with word, and 

3) shell input is read up to the first 
line that literally matches the re- 
sulting word, or to an end-of-file. 



If any character of word is quoted (see 
"Quoting," later), no additional processing 
is done to the shell input. If no charac- 
ters of word are quoted: 
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1) parameter and command substitution 
occurs, 

2) (escaped) \new-line is ignored, and 

3) \ must be used to quote the charac- 
ters \, $, and \ 

The resulting document becomes the stan- 
dard input. 

<&digit The standard input is duplicated from file 

descriptor digit. Similarly for the stan- 
dard output using >&--. 

<&- The standard input is closed. Similarly 

for the standard output using >. 

If one of the above is preceded by a digit, the file de- 
scriptor created is that specified by the digit (instead 
of the default 0 or 1). For example: 

... 2>&1 

creates file descriptor 2, (a duplicate of file descriptor 
1). 

The order in which redirections are specified is signifi- 
cant. The shell evaluates redirections left-to-right. 
For example: 

... l>xxx 2>&1 

first associates file descriptor 1 with file xxx. It as- 
sociates file descriptor 2 with the file associated with 
file descriptor 1 (i.e., xxx). If the order of redirec- 
tions were reversed, file descriptor 2 would be associated 
with the terminal (assuming file descriptor 1 had been) 
and file descriptor 1 would be associated with file xxx. 

Using the terminology introduced previously under 
"Commands," if a command is composed of several simple 
commands, redirection will be evaluated for the entire 
command before it is evaluated for each simple command. 
That is, the shell evaluates redirection for the entire 
list, then each pipeline within the list, then each com- 
mand within each pipeline, then each list within each com- 
mand. 
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If a command is followed by an ampersand (&), the default 
standard input for the command is the empty file 
/dev/nuU. Otherwise, the environment for the execution 
of a command contains the file descriptors of the invoking 
shell as modified by input/output specifications. 

Redirection of output is not allowed in the restricted 
shell. 



File Name Generation 

Following substitution, each command word is scanned for 
the characters *, ?, and [. If one of these characters 
appears, the word is regarded as a pattern. The word is 
replaced with alphabetically-sorted file names that match 
the pattern. If no file name is found that matches the 
pattern^ the word is left unchanged. A period (.) at the 
start of a file name, or immediately following a slash 
(/), must be matched explicitly. (The slash (/) must be 
explicitly matched as well.) 

These characters and their matching patterns are: 

* Matches any string, including the null string. 

? Matches any single character. 

[...] Matches any one of the enclosed characters. A 

pair of characters separated by - matches any 
character lexically between the pair, inclusive. 
If the first character following the opening "[" 
is a "!" any character not enclosed is matched. 



Quoting 

The following characters have a special meaning to the 
shell and cause termination of a word unless quoted 
(preceded with a backslash (\)): 

; & ( ) I " < > newline space tab 

A character may be quoted (i.e., made to stand for itself) 
by preceding it with a backslash (\) or inserting it be- 
tween a pair of quote marks (" or " "). During proces- 
sing, the shell may quote certain characters to prevent 
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them from taking on a special meaning. Backslashes used 
to quote a single character are removed from the word be- 
fore the command is executed. The pair \new-line is re- 
moved from a word before command and parameter substitu- 
tion. 

All characters enclosed between a pair of single quote 
marks ("), except a single quote, are quoted by the 
shell. Backslash has no special meaning inside a pair of 
single quotes. A single quote may be quoted inside a pair 
of double quote marks (for example, " ' "). 

Inside a part of double quote marks (" "), parameter and 
conmiand substitution occurs and the shell quotes the re- 
sults to avoid blank intepretation and file name genera- 
tion. If $* is within a pair of double quotes, the posi- 
tional parameters are substituted and quoted, separated by 
quoted spaces ("$1 $2 ..."); however, if $@ is within a 
pair of double quotes, the positional parameters are sub- 
stituted and quoted, separated by unquoted spaces ("$1" 
"$2" ... ). \ quotes the characters \, ', ", and $. The 
pair \new-line is removed before parameter and command 
substitution. If a backslash precedes characters other 
than \, ', ", $, and new-line, then the backslash itself 
is quoted by the shell. 



Prompting 

When used interactively, the shell prompts with the value 
of PSl before reading a command. If at any time a new- 
line is typed and further input is needed to complete a 
command, the secondary prompt (i.e., the value of PS2) is 
is used. 



Environment 

The environment (see environ(M)) is a list of name- value 
pairs that is passed to an executed program in the same 
way as a normal argument list. The shell interacts with 
the environment in several ways. On invocation, the shell 
scans the environment and creates a parameter for each 
name found, giving it the corresponding value. Executed 
commands inherit the same environment. If the user modi- 
fies the values of these parameters or creates new ones, 
none of these affects the environment unless the export 
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command is used to bind the shell's parameter to the en- 
vironment (see also set -a). A parameter may be removed 
from the environment with the unset command. The en- 
vironment seen by any executed command is thus composed of 
any unmodified name-value pairs originally inherited by 
the shell, minus any pairs removed by unset, plus any mod- 
ifications or additions, all of which must be noted in 
export commands. 

The environment for any simple conmiand may be augmented 
by prefixing it with one or more assignments to parameters. 
Thus: 

TERM=450 cmd CTgS 

and 

(export TERM; TERM=450; cmd) 

are equivalent (as far as the above execution of cmd is 
concerned). 

If the -k flag is set, all keyword arguments are placed in 
the environment, even if they occur after the command 
name. The following first prints a=b c and then c: 

echo a=b c 
set -k 
echo a=b c 



Signals 

The INTERRUPT and QUIT signals for an invoked conmiand 
are ignored if the command is followed by an ampersand 
(&); otherwise, signals have the values inherited by the 
shell from its parent, with the exception of signal 11 
(memory fault). (Also see the trap command under "Spe- 
cial Commands.") 



Execution 

Each time a command is executed, the above substitutions 
are carried out. If the command name does not match a 
Special Conmiand, but matches the name of a defined func- 
tion, the function is executed in the shell process (note 
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how this differs from the execution of shell procedures). 
The positional parameters $1, $2, ... are set to the 
arguments of the function. If the command name matches 
neither a Special Command nor the name of a defined func- 
tion, a new process is created and an attempt is made to 
execute the conmiand via exec(S). 

The shell parameter PATH defines the search path for the 
directory containing the command. Alternative directory 
names are separated by a colon (:). The default path is 
:/bin:/usr/bin (specifying the current directory, /bin, 
and /usr/bin, in that order). Note that the current di- 
rectory is specified by a null pathname, which can appear 
immediately after the equal sign or between the colon de- 
limiters anywhere else in the path list. If the conmiand 
name contains a /, the search path is not used. Other- 
wise, each directory in the path is searched for an exe- 
cutable file. If the file has execute permission but is 
not an binary executable file, it is assumed to be a file 
containing shell commands. A subshell (i.e., a separate 
process) is spawned to read it. A parenthesized command 
is also executed in a subshell. 

The location in the search path where a conmiand was found 
is remembered by the shell (to help avoid unnecessary 
execs later). If the command was found in a relative di- 
rectory, its location must be re-determined whenever the 
current directory changes. The shell forgets all remem- 
bered locations whenever the PATH variable is changed or 
the hash -r command is executed (see "Special Commands"). 



Special Commands 

Input/output redirection is now permitted for these com- 
mands, although they cannot be used in pipelines. File 
descriptor 1 is the default output location. 

: No effect; the command does nothing. A zero 

exit code is returned. 

. file Reads and executes commands from file and 
returns. The search path specified by PATH 
is used to find the directory containing file. 
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break [ n ] 

Exits from the enclosing for or while loop, if 
any. If n is specified, then breaks n levels. 

continue [ n ] 

Resumes the next iteration of the enclosing for 
or while loop. If n is specified, then resumes 
at the nth enclosing loop. 

cd [ arg ] 

Change the current directory to arg. The shell 
parameter HOME is the default arg. The shell 
parameter CDPATH defines the search path for 
the directory containing arg. Alternative di- 
rectory names are separated by a colon (:). The 
default path is <null> (specifying the current 
directory). Note that the current directory is 
specified by a null path name, which can appear 
immediately after the equal sign or between the 
colon delimiters anywhere else in the path list. 
If arg begins with a \ the search path is not 
used. Otherwise, each directory in the path is 
searched for arg. The cd command may not be 
executed by rsh. 

echo [ arg ... ] 

Echo arguments. See echo(C) for usage and de- 
scription. 

eval [ arg ... ] 

The arguments are read as input to the shell and 
the resulting command(s) executed. 

exec [ arg ... ] 

The command specified by the arguments is exe- 
cuted in place of this shell without creating a 
new process. Input/output arguments may appear 
and, if no other arguments are given, cause the 
shell input/output to be modified. 



exit [ n ] 



Causes a shell to exit with the exit status spe- 
cified by n. If n is omitted, the exit status 
is that of the last conmiand executed (an 
end-of-file will also cause the shell to exit). 
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export [ name ... ] 

The given names are marked for automatic export 
to the environment of subsequently executed com- 
mands. If no arguments are given, a list of all 
names marked for export in this shell is 
printed. (Variable names exported from a parent 
shell are listed only if they have been exported 
again during the current shell's execution.) 
Function names are not exported. 

getopts Use in shell scripts to support command sjmtax 
standard (see intro(C)); it parses positional 
parameters and checks for legal options. See 
getopts(C) for usage and description. 

hash [ -r ] [ name ... ] 

For each name, the location in the search path 
of the command specified by name is determined 
and remembered by the shell. The -r option 
causes the shell to forget all remembered loca- 
tions. If no arguments are given, information 
about remembered commands is presented, along 
with columns titled hits and cost. Hits is the 
number of times a command has been invoked by 
the shell. 



Cost is a measure of the work required to locate 
a command in the search path. If a command is 
found in a "relative" directory in the search 
path, after changing to that directory, the 
stored location of that command is recalculated. 
Commands for which this will be done are indi- 
cated by an asterisk (*) adjacent to the hits 
information. Cost will be incremented when the 
recalculation is done. 



newgrp [ org ... ] 

Equivalent to exec newgrp arg .... See 
newgrp(C) for usage and description. 

pwd Print the current working directory. See pwd(C' 

for usage and description. 
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read [ name ... ] 

One line is read from the standard input and, 
using the internal field separator, IFS 
(normally space or tab), to delimit word boun- 
daries, the first word is assigned to the first 
name, the second word to the second name, etc., 
with leftover words assigned to the last name. 
Lines can be continued using \new-line. Charac- 
ters other than new-line can be quoted by pre- 
ceding them with a backslash. These backslashes 
are removed before words are assigned to names, 
and no interpretation is done on the character 
that follows the backslash. The return code is 
0 unless an end-of-file is encountered. 

readonly [ name ... ] 

The given names are marked readonly and the 
values of the these names may not be changed 
by subsequent assignment. If no arguments are 
given, a list of all readonly names is printed. 

return [ n ] 

Causes a function to exit with the return value 
specified by n. If n is omitted, the return 
status is that of the last command executed. 

set [ -aefhkntuvx [ arg ... ] ] 

The following options can be used with the sh 
command directly, as well as with the set com- 
mand: 

-a Marks variables that are modified or 
created for export. 

-e If the shell is noninteractive, exits im- 
mediately if a command exits with a non- 
zero exit status. 

-k Places all keyword arguments in the en- 
vironment for a command, not just those 
that precede the conmiand name. 

-f Disables file name generation. 

-h Locates and remembers function commands 
as functions are defined (function commands 
are normally located when the function is 
executed). 
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-n Reads commands but does not execute them. 

-t Exits after reading and executing one com- 
mand. Intended for use by C programs 
only; not useful interactively. 

-u Treats unset variables as errors when sub- 
stituting. 

-V Prints shell input lines as they are read. 

-X Prints commands and their arguments as 
they are executed. 

Does not change any of the flags; useful in 
setting $1 to -. 

Using + rather than - causes these flags to be turned off. 
These flags can also be used when invoking the shell. The 
current set of flags, including those listed under 
"Invocation," which follows, may be found in $-. The re- 
maining arguments are positional parameters and are as- 
signed, in order, to $1, $2, .... If no arguments are 
given, the values of all names are printed. 

shift [ n ] 

The positional parameters from $n+l ... are 
renamed $1 .... If n is not given, it is as- 
sumed to be 1. 

test Evaluates conditional expressions. See test(C) 

for usage and description. 

times Prints the accumulated user and system times for 
processes run from the shell. 

trap [ org ] [ n ] 

The command arg is read and executed when the 
shell receives signal(s) n. {Arg is scanned 
once when the trap is set and once when the 
trap is taken.) 

Trap commands are executed in order of signal 
number. The highest signal number allowed is 
16. Any attempt to set a trap on a signal that 
was ignored on entry to the current shell is 
ineffective. An attempt to trap on signal 11 
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(memory fault) produces an error, because the 
shell uses this signal internally. If arg is 
absent, then all trap(s) n are reset to their 
original values. If arg is the null string, 
P this signal is ignored by the shell and by the 

commands it invokes. If n is 0, the command arg 
is executed on exit from the shell. The trap 
command with no arguments prints a list of com- 
mands associated with each signal number. 

type [ name ... ] 

For each namey indicate how it would be inter- 
preted if used as a command name. 

ulimit [ n ] 

Impose a size limit of n blocks on files written 
by the shell and its child processes (files of 
any size may be read). If n is omitted, the 
current limit is printed. You may lower your 
own ulimit, but only the super-user (see su(C)) 
can raise a ulimit. 



umask [ nnn ] 

The user file-creation mask is set to nnn (see 
umask(C)). If nnn is omitted, the current value 
of the mask is printed. 

unset [ name ... ] 

For each name, remove the corresponding variable 
or function. The variables PATH, PSl, PS2, 
MAILCHECK and IFS cannot be unset. 



wait [ n ] 

Wait for your background process whose process 
id is n and report its termination status. If n 
is omitted, all your shell's currently active 
background processes are waited for and the re- 
turn code will be zero. 
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Invocation 

If the shell is invoked through exec(C) and the first 
character of argument zero is -, commands are initially 
read from /etc/profile and from $HOME/. profile, if such 
files exist. Thereafter, commands are read as described 
below, which is also the case when the shell is invoked as 
/bin/sh. The flags below are interpreted by the shell on 
invocation only. 

-c stnng If the -c flag is present, commands are read 
from string. 

-s If the -s flag is present or if no arguments 

remain commands are read from the standard in- 
put. Any remaining arguments specify the posi- 
tional parameters. Shell output (except for 
Special Commands) is written to file descriptor 
2. 

-i If the -i flag is present or if the shell input 

and output are attached to a terminal, the shell 
is interactive. In this case TERMINATE is 
ignored so that kill 0 does not kill an interac- 
tive shell) and INTERRUPT is caught and ignored 
(so that wait is interruptible). In all cases, 
QUIT is ignored by the shell. 

-r If the -r flag is present, the shell is a re- 

stricted shell. 

The remaining flags and arguments are described under the 
set command above. 



Rsh Only 

Rsh is used to set up login names and execution environ- 
ments whose capabilities are more controlled than those of 
the standard shell. The actions of rsh are identical to 
those of sh, except that the following are disallowed: 

• Changing directory (see cd(C)) 

• Setting the value of $PATH 
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• Specifying path or command names containing / 

• Redirecting output (> and »). 

The restrictions above are enforced after .profile is in- 
terpreted. 

A restricted shell can be invoked in one of the following 
ways: 

• Rsh is the file name part of the last entry in the 
/etc/passwd file (see passwd(M)). 

• The environment variable SHELL exists and rsh is the 
file name part of its value. 

• The shell is invoked; rsh is the file name part of 
argument 0. 

• The shell is invoked with the -r option. 

When a conmiand to be executed is found to be a shell pro- 
cedure, rsh invokes sh to execute it. Thus, it is pos- 
sible to provide to the end-user shell procedures that 
have access to the full power of the standard shell, while 
imposing a limited menu of commands; this scheme assumes 
that the end-user does not have write and execute permis- 
sions in the same directory. 

The net effect of these rules is that the writer of 
.profile (see profile(M)) has complete control over user 
actions by performing guaranteed setup actions and leaving 
the user in an appropriate directory (probably not the 
login directory). 

The system administrator often sets up a directory of com- 
mands (i.e., /usr/rbin) that can be safely invoked by a 
restricted shell. Some systems also provide a restricted 
editor, red. Note that PATH must be set to something 
other than the default to prevent the user from simply 
invoking an unrestricted shell by typing sh. 
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Exit Status 

Errors detected by the shell, such as ssmtax errors, cause 
the shell to return a non-zero exit status. If the shell 
is being used non-interactively, execution of the shell 
file is abandoned. Otherwise, the shell returns the exit 
status of the last command executed (see also the exit 
command described previously). 



Files 

/etc/profile 
$HOME/.profile 
/tmp/sh* 
/dev/nuU 



See Also 

cd(C), echo(C), env(C), getops(C), intro(C), login(C), 
newgrp(C), profile(M), pwd(C), test(C), umask(C), wait(C), 
and dup(S), exec(S), fork(S), pipe(S), signal(S), 
ulimit(S) in the Reference (CP, S, F) 

User's Guide 



Caveats 

Words used for file names in input/output redirection are 
not interpreted for file name generation (see "File Name 
Generation," above). For example, cat filel >a* will 
create a file named a*. 

Because commands in pipelines are run as separate pro- 
cesses, variables set in a pipeline have no effect on the 
parent shell. 

If you get the error message "cannot fork, too many 
processes," try using the wait(C) command to clean up your 
background processes. If this doesn't help, the system 
process table is probably full or you have too many active 
foreground processes. (There is a limit to the number of 
process ids associated with your login, and to the number 
the system can keep track of.) 
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Notes 

If a command is executed, and a command with the same 
name is installed in a directory in the search path 
(before the directory where the original command was 
found), the shell will continue to exec the original com- 
mand. Use the hash command to correct this situation. 

If you move the current directory or one above it, pwd may 
not give the correct response. Use the cd command with a 
full path name to correct this situation. 

Not all the processes of a 3- or more-stage pipeline are 
children of the shell, and thus cannot be waited for. 

For wait n, if n is not an active process id, all your 
shell's currently active background processes are waited 
for and the return code will be zero. 
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Name 

shl - Shell layer manager. 



Syntax 
shl 



Description 

Shl allows a user to interact with more than one shell 
from a single terminal. The user controls these shells, 
known as layers^ using the commands described below. 

The current layer is the layer which can receive input 
from the keyboard. Other layers attempting to read from 
the keyboard are blocked. Output from multiple layers is 
multiplexed onto the terminal. To have the output of a 
layer blocked when it is not current, the stty option 
-loblk may be set within the layer. 

The stty(C) character swtch (set to " if NUL) is used to 
switch control to shl from a layer. Shl has its own 
prompt, »>, to help distinguish it from a layer. A layer 
is a shell which has been bound to a virtual tty device 
(/dev/sxt???). The virtual device can be manipulated like 
a real tty device using stty(C) and ioctl(S). Each layer 
has its own process group id. 



Definitions 

A name is a sequence of characters delimited by a blank, 
tab, or new-line. Only the first eight characters are 
significant. The names (1) through (7) cannot be used 
when creating a layer. They are used by shl when no name 
is supplied. They may be abbreviated to just the digit. 
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Commands 

The following commands may be issued from the shl prompt 
level. Any unique prefix is accepted. 

} 

^ create [ name ] Create a layer called name and make 

it the current layer. If no argu- 
ment is given, a layer will be 
created with a name of the form (#) 
where # is the last digit of the 
virtual device bound to the layer. 
The shell prompt variable PSl is set 
to the name of the layer followed by 
a space. A maximum of seven layers 
can be created. 

block name [ name ... ] 

For each name, block the output of 
the corresponding layer when it is 
not the current layer. This is 
equivalent to setting the stty op- 
tion -loblk within the layer. 

delete name [ name ... ] 
^ For each name, delete the corres- 

ponding layer. All processes in the 
process group of the layer are sent 
the SIGHUP signal (see signal(S)). 

help (or ?) Print the syntax of the shl commands. 

layers [ -1 ] [ name ... ] 

For each name, list the layer name 
and its process group. The -1 
option produces a ps(C)-like list- 
ing. If no arguments are given, 
information is presented for all 
existing layers. 

resume [ name ] Make the layer references by name 
the current layer. If no argument 
is given, the last existing current 
layer will be resumed. 

toggle Resume the layer that was current 

before the last current layer. 
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unblock name [ name ... ] 

For each name, do not block the out- 
put of the corresponding layer when 
it is not the current layer. This 
is equivalent to setting the stty 
option -loblk within the layer. 



quit Exit shl. All layers are sent the 

SIGHUP signal. 

name Make the layer referenced by name 

the current layer. 



Files 



/dev/sx??? 
$SHELL 



Virtual tty devices 

Variable containing path name of 
the shell to use (default is /bin/sh). 



See Also 

sh(C), stty(C), ioctl(S), signal(S) 
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Name 

size - Prints section sizes in bytes of common object 
files. 



Syntax 

size [-n] [-f] [-o] [-x] [-d] [-V] files 



Description 

The size command produces section size information in 
bytes for each loaded section in the common object files 
(COFF). The size of the text, data, and bss 
(uninitialized data) sections is printed, as well as the 
sum of the sizes of these sections. If an archive file is 
input to the size command the information for all archive 
members is displayed. 

The -n option includes NOLOAD sections in the size. 

The -f option produces full output, that is, it prints the 
size of every loaded section, followed by the section name 
in parentheses. 

The -d option prints numbers in decimal (the default). 
The -o or -x option prints in octal or in hexadecimal, 
respectively. 

The -V option will supply the version information on the 
size command. 



See Also 

as(CP), cc(CP), Id(CP), ar(F) in the Reference (CP, S, F) 



Notes 

Since the size of bss sections is not known until 
link-edit time, the size conmiand will not give the true 
total size of pre-linked objects. 
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Diagnostics 

size: name: cannot open 

if name cannot be read. 

size: name: bad magic 

if name is not an appropriate common object file. 
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Name 

sizefs - Determines the size of a logical device from the 
layout information associated with a hard disk. 



Syntax 

sizefs layout-file logical-device-number 



Description 

The sizefs command prints the size in sectors of the area 
on the disk you specify. It gets its information out of 
the structure created by the layout (C) command. Its most 
common use is in shell scripts to create a file system on 
the hard disk, where the size of the root partition is 
used as an argument to mkfs(M) or archive(C). 

Logical device number 0 is the size of the entire disk 
(excluding bad blocks). For example, 

sizefs /dev/hdO. layout 2 

returns the size of the root file system. 



Related Commands 

layout(C), mkfs(M) 
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Name 

sleep - Suspends execution of a command for a specified 
interval. 



Syntax 

sleep time 



Description 

The sleep command suspends execution of a command for a 
specified number of seconds. It is used to execute a com- 
mand after a certain amount of time as in; 

(sleep 105; command) & 

or to execute a command every so often, as in: 

while true 
do 

command 
sleep 37 

done 

Time must be less than 4,294,967,295 (2 -1) seconds for 
the Series 386. 
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Name 

sort - Sorts and merges files. 



Syntax 

sort [-emu] [-ooutput] [-TdiTectory] [-ykmem] [-zrecsz] 
[-dfiMnr] [-btx] [+pos] [-pos] [file ...] 



Description 

The sort command merges and sorts lines from all named 
files and writes the result on the standard output. A 
dash (-) may appear as a file in the files argument signi- 
fying the standard input. If no input files are named, 
the standard input is sorted. 

The default sort key is an entire line. Default ordering 
is lexicographic by bytes in machine collating sequence. 
The ordering is affected globally by the options you spe- 
cify with the command. 



Options 

The following options alter output behavior: 

-c Checks that the input file is sorted according 

to the ordering rules; gives no output unless 
the file is out of sort. 

-m Merges only, the input files are already sorted. 

-u Suppresses all but one in each set of duplicated 

lines. Ignored bytes and bytes outside keys do 
not participate in this comparison. 

-ooutput Uses output file instead of the standard output. 

This file may be the same as one of the inputs. 
There may be ptional blanks between -o and 
output. 

-Tdirectory 

Uses directory as a temporary directory (instead 
of /usr/tmp or /tmp) when doing the sort. 
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The amount of main memory used by the sort has 
a large impact on its performance. Sorting a 
small file in a large amount of memory is a 
waste. If this option is omitted, sort begins 
using a system default memory size, and con- 
tinues to use more space as needed. If this 
option is presented with a value, femem, sort 
will start using that number of kilobytes of 
memory, unless the administrative minimum or 
maximum is violated, in which case the corre- 
sponding limit will be used. By convention, -y 
(with no argument) starts with maximum memory. 

The size of the longest line read is recorded in 
the sort phase so buffers can be allocated dur- 
ing the merge phase. If the sort phase is 
omitted via the -c or -m options, a popular sys- 
tem default size will be used. Lines longer 
than the buffer size will cause sort to termi- 
nate abnormally. Supplying Tecsz the actual 
number of bytes in the longest line to be merged 
(or some larger value) will prevent termination. 

The following options override the default ordering rules: 

-d "Dictionary" order: only letters, digits and 

blanks are significant in comparisons. 

-f Folds uppercase letters onto lowercase. 

-i Ignores characters outside the ASCII octal range 

040 - 0176 in non-numeric comparisons. 

-M Compare as months. The first three non-blank 

characters of the field are folded to uppercase 
and compared so that "JAN" < "FEB" < ...< 
"DEC." Invalid fields compare low to "JAN." 
This option implies -b. 

-n An initial numeric string, consisting of op- 

tional blanks, optional minus sign, and zero or 
more digits with optional decimal point, is 
sorted by arithmetic value. Option n implies 
option b. 

-r Reverses the sense of comparisons. 



-ykmem 



-zTecsz 
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The notation +posl -pos2 restricts a sort key to a field 
beginning at posl and ending at pos2. 



\ NOTE 

Column 0 is the starting position (posl 
column 0). 



Specifying posl and pos2 involves the notion of a field, a 
minimal sequence of characters followed by a field sepa- 
rator or a new-line. By default, the first blank (space 
or tab) of a sequence of blanks acts as the field separa- 
tor. All blanks in a seqi*ence of blanks are considered to 
be part of the first field. The treatment of field sepa- 
rators can be altered using the options: 



-tx Use X as the field separator character; x is not con- 
sidered to be part of a field (although it may be 
included in a sort key). Each occurrence of x is 
significant (e.g., xx delimits an empty field. 

-b Ignore leading blanks when determining the starting 
/ and ending positions of a restricted sort key. If 

the -b option is specified before the first +posl 
argument, it will be applied to all +posl arguments. 
Otherwise, the b flag may be attached independently 
to each +posl or -pos2 argument (see below). 



Posl and pos2 each have the form m.n optionally followed 
by one or more of the flags bdfinr. A starting position 
specified by +m.n is interpreted to mean the n+lst charac- 
ter in the m+lst field. A missing .n means .0, indicating 
the first character of the m+ 1st field. If the b flag is 
in effect, n is counted from the first non-blank in the 
m+lst field; +m.Ob refers to the first non-blank charac- 
ter in the m+lst field. 



A last position specified by -m.n is interpreted to mean 
the nth character (including separators) after the last 
character of the mth field. A missing .n means .0, indi- 
cating the last character in the mth field. If the b flag 
is in effect, n is counted from the last leading blank in 
the m+lst field; -m.b refers to the first non-blank in the 
m+lst field. 
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When there are multiple sort keys, later keys are compared 
only after all earlier keys compare equal. Lines that 
otherwise compare equal are ordered with all bytes signi- 
ficant. Very long lines are silently truncated. 



Examples 

This command prints an alpabetized list of all the unique 
spellings in a list of words (capitalized words differ 
from uncapitalized). 

sort -u +0f +0 list 

This conmiand prints the password file sorted by user ID. 

sort -t: +2n /etc/passwd 

This command prints the first instance of each month in an 
already-sorted file of month-day entries. 

sort -um +0-1 dates 
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Name 



spell, hashmake, spellln, hashcheck - Finds spelling 
errors. 



Syntax 



speU [ -V ] [ -b ] [ -X ] [ -1 ] [ *localJile ] [ files ] 
/usr/lib/spell/hashmake 
/usr/lib/spell/spellin n 

/usr/lib/spell/hashcheck spell ing lis t 



Description 

SpeU collects words from the named files and looks them 
up in a spelling list. Words that neither occur among nor 
are derivable (by applying certain inflections, prefixes, 
and/or suffixes) from words in the spelling list are 
printed on the standard output. If no files are nanjed, 
words are collected from the standard input. 

Spell ignores most troff(l), tbl(l), and eqn(l) construc- 
tions. 

Under the -v option, all words not literally in the spell- 
ing list are printed, and plausible derivations from the 
words in the spelling list are indicated. 

Under the -b option, British spelling is checked. Besides 
preferring centre, colour, programmet speciality^ 
travelledy etc., this option insists upon -ise in words 
like standardise i Fowler and the OED to the contrary not- 
withstanding. 

Under the -x option, every plausible stem is printed with 
= for each word. 

By default, spell (like deroff(l)) follows chains of in- 
cluded files (.so and .nx troff(l) requests), unless the 
names of such included files begin with /usr/lib. Under 
the -1 option, spell will follow the chains of all in- 
cluded files. 
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Under the *local_file option, words found in localJUe 
are removed from spell's output. Local Jile is the name 
of a user-provided file that contains a sorted list of 
words, one per line. With this option, the user can spe- 
cify a set of words that are correct spellings (in addi- 
tion to spell's own spelling list) for each job. 

The spelling list is based on many sources, and while more 
haphazard than an ordinary dictionary, is also more effec- 
tive with respect to proper names and popular technical 
words. Coverage of the specialized vocabularies of bio- 
logy, medicine, and chemistry is light. 

Pertinent auxiliary files may be specified by name argu- 
ments, indicated below with their default settings (see 
FILES). Copies of all output are accumulated in the his- 
tory file. The stop list filters out misspellings (e.g., 
thier=thy-y+ier) that would otherwise pass. 

Three routines help maintain and check the hash lists used 
by spell: 

hashmake Reads a list of words from the standard 



input and writes the corresponding 
nine-digit hash code on the standard out- 
put. 



spellin 



Reads n hash codes from the standard input 
and writes a compressed spelling list on 
the standard output. 



hashcheck 



Reads a compressed spelling list and re- 
creates the nine-digit hash codes for all 
the words in it; it writes these codes on 
the standard output. 



Files 



S_SPELL=/usr/lib/spell/hstop 

H_SPELL=/usr/lib/spell/spellhist 

/usr/lib/spell/spellprog 



D_SPELL=/usr/lib/spell/hlist[ab] 



Hashed spelling lists, 
American/British 
Hashed stop list 
History file 
Spell program 
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See Also 

sed(C), sort(C), tee(C), and dtroff(l) 

eqn(l), tbl(l), troff(l) in the DOCUMENTER'S 

WORKBENCH 



Bugs 

The spelling list's coverage is uneven; new installations 
will probably wish to monitor the output for several 
months to gather local additions; typically, these are 
kept in a separate local file that is added to the hashed 
spelling _list via spellin. 
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Name 

spline - Interpolates smooth curve. 



Syntax 

spline [ options ] 



Description 

Spline takes pairs of numbers from the standard input as 
abcissas and ordinates of a function. It produces a sim- 
ilar set, which is approximately equally spaced and in- 
cludes the input set, on the standard output. The cubic 
spline output has two continuous derivatives, and enough 
points to look smooth when plotted. 

The following options are recognized, each as a separate 
argument: 

-a Supplies abscissas automatically (they are mis- 

sing from the input); spacing is given by the 
next argument, or is assumed to be 1 if next 
argument is not a number. 

-k num The constant num used in the boundary value 
computation: 

y = num y * y " = num y 

0 1 n n-l 

is set by the next argument. By default 
num = 0. 

-n num Spaces output points so that approximately num 
intervals occur between the lower and upper x 
limits. Num is a positive interger; the default 
is 100. 

-p Makes output periodic, i.e., match derivatives 

at ends. First and last input values should 
normally agree. 
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-X Next 1 (or 2) arguments are lower (and upper) x 

limits. Normally, these limits are calculated 
from the data. Automatic abcissas start at 
lower limit (default 0). 



Diagnostics 

When data is not strictly monotone in x, spline reproduces 
the input without interpolating extra points. 



Notes 

A limit of 1000 input points is silently enforced. 
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Name 

split - Splits a file into pieces. 



Syntax 

split [ -n ] [ file [ name ] ] 



Description 

Split reads file and writes it in n-line pieces (default 
1000) onto a set of output files. The name of the first 
output file is name with aa appended, and so on lexicog- 
raphically. If no output name is given, x is used by de- 
fault. 

If no input file is given, or if a dash (-) is given in- 
stead, the standard input file is used. 



See Also 

t>fs(C), csplit(C) 
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Name 

ssp - Removes consecutive blank lines. 

) Syntax 

ssp [ - ] [ file ... ] 

Description 

Ssp compresses consecutive blank lines to at most one 
blank line to produce more compact output for a CRT ter- 
minal or save paper on the printer. If the optional - is 
given, ssp is even more zealous, and gets rid of all empty 
lines. 
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Name 

strings - Finds the printable strings in an object file. 



Syntax 

strings [-] [-o] [ -number ] file ... 



Description 

Strings looks for ASCII strings in a binary file. A 
string is any sequence of four or more printing characters 
ending with a newline or a null character. Unless the - 
flag is given, strings only looks in the initialized data 
space of object files. 

-o Each string is preceded by its decimal offset in 

the file. 

-number Uses number as the minimum string length rather 
than 4. 

Strings is useful for identifying random object files and 
many other things. 



See Also 

hd(C), od(C) 



Credit 

This utility was developed at the University of California 
at Berkeley and is used with permission. 
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Name 

stty - Sets the options for a terminal. 



Syntax 

stty [ -a ] [ -g ] [ options ] 



Description 



Stty sets certain terminal I/O options for the device that 
is the current standard input; without arguments, it re- 
ports the settings of certain options. 



See xtty(C) for stty extensions. 



In this report, if a character is preceded by a caret ("), 
then the value of jthat option is the corresponding control 
characte r (e.g., is ■wwHip: in this ca se, recall that 
KWiiBi» is the same as the BSBBtBSBBBBB key.) The sequence 
means that an option has a null value. 



-a Reports all of the option settings. 

-g Reports current settings in a form that can be used 
as an argument to another stty command. 

Options in the last group are implemented using options in 
the previous groups. Note that many combinations of op- 
tions make no sense, but no sanity checking is performed. 
The options are selected from the following: 



Control Modes 

parenb (-parenb) 

parodd (-parodd) 
cs5 cs6 cs7 cs8 
0 



Enable (disable) parity generation 
and detection. 

Select odd (even) parity. 

Select character size (see termio(M)). 

Hang up phone line immediately. 



1 



STTY(C) 



STTY(C) 



110 300 600 1200 

hupcl (-hupcl) 

hup (-hup) 
cstopb (-cstopb) 
cread (-cread) 
clocal (-clocal) 

loblk (-loblk) 

Input Modes 

ignbrk (-ignbrk) 
brkint (-brkint) 
ignpar (-ignpar) 
parmrk (-parmrk) 

inpck (-inpck) 

istrip (-istrip) 

inlcr (-inlcr) 
igncr (-igncr) 
icrnl (-icml) 
iuclc (-iuclc) 



1800 2400 4800 9600 19200 38400 

Set terminal baud rate to the number 
given, if possible. (All speeds are 
not supported by all hardware inter- 
faces. ) 

Hang up (do not hang up) dataphone 
connection on last close. 

Same as hupcl (-hupcl). 

Use two (one) stop bits per character. 

Enable (disable) the receiver. 

Assume a line without (with) modem 
control. 

Block (do not block) output from a 
non-current layer. 



Ignore (do not ignore) break on input. 

Signal (do not signal) INTR on break. 

Ignore (do not ignore) parity errors. 

Mark (do not mark) parity errors (see 
termio(M)). 

Enable (disable) input parity 
checking. 

Strip (do not strip) input characters 
to seven bits. 

Map (do not map) NL to CR on input. 

Ignore (do not ignore) CR on input. 

Map (do not map) CR to NL on input. 

Map (do not map) upper-case alpha- 
betics to lower case on input. 
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ixon (-ixon) Enable (disable) START/STOP output 

control. Output is stopped by sending 
an ASCII DCS and started by sending 
an ASCII DCl. 

ixany (-ixany) Allow any character (only DCl) to 

restart output. 

ixoff (-ixoff) Request that the system send (not 

send) START/STOP characters when 
the input queue is nearly empty/full. 



Output Modes 

opost (-opost) 

olcuc (-olcuc) 

onlcr (-onlcr) 

ocml (-ocml) 
onocr (-oncer) 
onlret (-onlret) 

ofiU (-ofUl) 

of del (-of del) 
crO crl cr2 cr3 

nlO nil 

tabO tabl tab2 tabS 



Post-process output (do not post- 
process output; ignore all other 
output modes). 

Map (do not map) lower-case alpha- 
betics to upper case on output. 

Map (do not map) NL to CR-NL on 
output. 

Map (do not map) CR to NL on output. 

Do not (do) output CRs at column zero. 

On the terminal NL performs (does not 
perform) the CR function. 

Use fill characters (use timing) for 
delays. 

Fill characters are DELs (NULs). 

Select style of delay for carriage 
returns (see termlo(M)). 

Select style of delay for line-feeds 
(see terniio(M)). 



Select style of delay for horizontal 
tabs (see termio(M)). 
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bsO bsl 
ffO ffl 
vtO vtl 

.Local Modes 

isig (-isig) 

icanon (-Icanon) 
xcase (-xcase) 
echo (-echo) 
echoe (-echoe) 

echok (-echok) 

Ifkc (-Ifkc) 
echonl (-echonl) 
noflsh (-noflsh) 



Select style of delay for backspaces 
(see termio(M)). 

Select style of delay for form-feeds 
(see tennio(M)). 

Select style of delay for vertical 
tabs (see termio(M)). 



Enable (disable) the checking of 
characters against the special control 
characters INTR, QUIT, and SWTCH. 

Enable (disable) canonical input 
(ERASE and KILL processing). 

Canonical (unprocessed) upper/lower- 
case presentation. 

Echo back (do not echo back) every 
character typed. 

Echo (do not echo) ERASE character 
as a backspacespace-backspace string. 
Note: this mode will erase the 
ERASEed character on many CRT 
terminals; however, it does not keep 
track of colunm position and, as a 
result, may be confusing on escaped 
characters, tabs, and backspaces. 

Echo (do not echo) NL after KILL 
character. 

The same as echok (-echok); obsolete. 

Echo (do not echo) NL. 

Disable (enable) flush after INTR, 
QUIT, or SWTCH. 
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Control Assignments 



control-character c 



line i 



Set control-character to c, where 
control-character is erase, kill, 
Intr, quit, swtch, eof, ctab, mln, or 
time (ctab is used with -stappl; min 
and time are used with -icanon; see 
termio(M)). If c is preceded by an 
(escaped from the shell) caret (*), 
the n the v alue used is the correspond- 
ing mmwiM character (e.g., *d is a 
■WiaPB ): is interpreted as 
and is interpreted as undefined. 



Set line discipline to i (0 < i < 
127). 



Combination Modes 
evenp or parity 
oddp 



Enable parenb and cs7. 

Enable parenb, cs7, and parodd. 



-parity, -evenp, or -oddp 

Disable parenb, and set cs8. 



raw (-raw or cooked) 

nl-(-nl) 

lease (-lease) 
LCASE (-LCASE) 
tabs (-tabs or tab3) 

ek 



Enable (disable) raw input and output 
(no ERASE, KILL, INTR, QUIT, SWTCH, 
EOT, or output post processing). 

Unset (set) icml, onlcr. In addition 
-nl unsets inlcr, igncr, ocml, and 
onlret. 

Set (unset) xcase, luclc, and olcuc. 
Same as lease (-lease). 



Preserve (expand to spaces) tabs when 
printing. 

Reset ERASE and KILL characters 
back to normal # and @. 
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sane Resets all modes to some reasonable 

values. 

term Set all modes suitable for the ter- 

minal type term, where term is one of 
tty33, tty37, vt05, tnSOO, ti700, or 
tek. 



See Also 



tabs(C), termio(M) and ioctl(S) in the Reference 
(CP, S, F) 
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Name 



su - Become super-user or another user without logging 
off. 



Syntax 

su [-] [name [arg ,..]] 



Description 

Su allows one to become another user without logging off. 
The default user name is root (i.e., super-user). If a 
user name has a password, su prompts for the user's pass- 
word. 

To use su, the appropriate password must be supplied 
(unless one is already root). If the password is correct, 
su will execute a new shell with the real and effective 
user ID set to that of the specified user. The new shell 
will be the optional program named in the shell field of 
the specified user's password file entry (see passwd(M)), 
or /bin/sh if none is specified (see sh(C)). To restore 
normal user ID privileges, exit the new shell. 

The following statements are true only if the optional 
program named in the shell field of the specified user's 
password file entry is like sh(C). If the first argument 
to su is a -, the environment will be changed to what 
would be expected if you actually logged in as the speci- 
fied user. This is done by invoking the program used as 
the shell with an argO value whose first character is -, 
thus causing first the system's profile (etc/profile) and 
then the specified user's profile (.profile in the new 
HOME directory) to be executed. Otherwise, the environ- 
ment is passed along with the possible exception of $PATH, 
which is set to /bin: /etc: /usr /bin for root. If the op- 
tional program used as the shell is /bin/sh, the user's 
.profile can check argO for -sh or -su to determine if it 
was invoked by login(C) or su(C), respectively. If the 
user's program is other than /bin/sh then .profile is in- 
voked with an argO of -program by both login(C) and su(C). 
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Examples 



To become user bin while retaining your previously ex- 
ported environment, type: 

su bin 

To become user bin but change the environment to what 
would be expected if bin had originally logged in, type: 

su - bin 

To execute a command with the temporary environment and 
permissions of user bin, type: 

su - bin -c command args 



See Also 

env(C), login(C), sh{C), passwd(C), profile(M), environ(M) 



Files 



/etc/passwd 
/etc/profile 
$HOME/.profile 
/usr/adm/sulog 



System's password file 
System's profile 
User's profile 
Log file 



2 



SUM(C) 



SUM(C) 



Name 

sum - Calculates checksum and counts blocks in a file. 

* Syntax 

sum [ -r ] file ... 



Description 

Sum calculates and prints a 16-bit checksum for the named 
filet and also prints the number of blocks in the file. 
It is typically used to look for bad spots, or to validate 
a file communicated over a transmission line. 

-r Causes an alternate algorithm to be used in computing 
the checksum. 



See Also 

wc(C) 



Diagnostics 

"Read error" is not distinguishable from end-of-file on 
most devices; therefore, check the block count. 
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Name 

swap - Changes swap device configuration. 



Sjntitax 

/etc/swap -a swapdev swaplow swaplen 
/etc/swap -d swapdev swaplow 
/etc/swap -1 



Description 

Swap provides a method of adding, deleting, and monitoring 
the system swap areas used by the memory manager. The 
following options are recognized. 

-a Add the specified swap area. Swapdev is the name of 
the block special device, e.g., /dev/hdOa. Swaplow 
is the offset in 512-byte blocks into the device 
where the swap area should begin. Swaplen is the 
length of the swap area in 512-byte blocks. This 
option can only be used by the super-user. Swap 
areas are normally added by the system start-up rou- 
tine /etc/rc when going into multi-user mode. 

-d Delete the specified swap area. Swapdev is the name 
of block special device, e.g., /dev/hdOa. Swaplow is 
the offset in 512-byte blocks into the device where 
the swap area begins. Using this option marks the 
swap area as "INDEL" (in process of being deleted). 
The system will not allocate any new blocks from the 
area, and will try to free swap blocks from it. The 
area will remain in use until all blocks from it are 
freed. This option can only be used by the 
super-user. 

-1 List the status of all the swap area. The output has 
four columns: 

DEV The swapdev special file for the swap area 

if one can be found in the or /dev direc- 
tory, and its major/minor device number in 
decimal. LOW The swaplow value for the 
area in 512-byte blocks. 
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LEN The swaplen value for the area in 512-byte 

blocks. 

FREE The number of free 512-byte blocks in the 
area. If the swap area is being deleted, 
this column will be marked INDEL. 



Warnings 



No check is done to see if a swap area being added over- 
laps with an existing swap area or file system. 
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Name 

sync - Updates the super block. 



Syntax 
sync 



Description 

The sync command executes the sync(S) system primitive. 
If the system is to be stopped, sync must be called to 
insure file system integrity. It will flush all previous- 
ly unwritten system buffers out to disk, thus assuring 
that all file modifications up to that point will be 
saved. Shutdown(M) automatically calls sync before shut- 
ting down the system. 

Sync will only write local buffers to local disks. So, if 
you do a write to a file on a remote machine in an RFS 
environment, sync will not force buffers to be written out 
to disk on the remote machine. 



See Also 

sync(S) in the Reference (CP, S, F) 
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Name 

sysconf - Prints system configuration information. 

Syntax 

sysconf [ -pnrafcv ] 



Description 

Sysconf prints system configuration information. 

If you type sysconf without any options, you will see all 
of the information below. 

The options are: 

-p Displays the number of processors installed on the 
system. 

-n Displays the maximum number of processes allowed to 
exist systemwide. 

-r Displays the amount of real memory. 

-a Displays the amount of available memory. 

-f Displays "fp" if a floating point co-processor is in- 
stalled and "fpem" if not. 

-c Displays the types of communication boards in- 
stalled. The logical number of the board is dis- 
played first, followed by a followed by the 
board tj^pe. An "m" represents a Multidrop board, 
an "s" represents a SIO board, and an "a" repre- 
sents an ACPA board. For the 386 Series 1000, an 
SIO will be reported as a Multidrop. Multiple SIO 
boards appear only as one board (e.g., 0:m). 

-V Displays the version string of the kernel. 



See Also 

sysconf (S) 
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Name 

tabs - Sets tabs on a terminal. 



Syntax 

tabs [tabspec] [-Ttype] [+mn] 



Description 

Tabs sets the tab stops on the user's terminal according 
to the tab specification tabspeCt after clearing any pre- 
vious settings. The user's terminal must have 
remotely-settable hardware tabs. 

tabspec Four types of tab specification are ac- 

cepted for tabspec. They are described 
below: canned (-code), repetitive (-n), 
arbitrary (nl,n2,...), and file {—file). 
If no tabspec is given, the default value 
is -8, i.e., operating system "standard" 
tabs. The lowest column number is 1. 
Note that for tabs, column 1 always refers 
to the leftmost column on a terminal, even 
one whose column markers begin at 0, e.g., 
the DASI 300, DASI 300s, and DASI 450. 

-code Use one of the codes listed below to select 

a canned set of tabs. The legal codes and 
their meanings are as follows: 

-a 1,10,16,36,72 

Assembler, IBM S/370, first format 

-a2 1,10,16,40,72 

Assembler, IBM S/370, second format 

-c 1,8,12,16,20,55 

COBOL, normal format 
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-c2 1,6,10,14,49 

COBOL compact format (coluimis 1-6 
omitted). Using this code, the first 
typed character corresponds to card 
column 7, one space gets you to 
column 8, and a tab reaches column 
12. Files using this tab setup should 
include a format specification as 
follows (see fspec(F)): 

<:t-c2 m6 s66 d:> 

-c3 1,6,10,14,18,22,26,30,34,38,42,46,50, 
54, 58, 62, 67 

COBOL compact format (columns 1-6 
omitted), with more tabs than -c2. 
This is the recommended format for 
COBOL. The appropriate format spe- 
cification is (see fspec(F)): 

<:t-c3 m6 s66 d:> 

-f 1,7,11,15,19,23 
FORTRAN 

-p 1,5,9,13,17,21,25,29,33,37,41,45,49, 
53 , 57, 61 
PL/1 

-s 1,10,55 
SNOBOL 

-u 1,12,20,44 

UNI VAC 1100 Assembler 

-n A repetitive specification requests tabs 

at columns 1+n, l+2*n, etc. Of particular 
importance is the value 8: this represents 
the operating system "standard" tab set- 
ting, and is the most likely tab setting to 
be found at a terminal. Another special 
case is the value 0, implying no tabs at 
all. 
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The arbitrary format permits the user to 
type any chosen set of numbers, separated 
by commas, in ascending order. Up to 40 
numbers are allowed. If any number (ex- 
cept the first one) is preceded by a plus 
sign, it is taken as an increment to be 
added to the previous value. Thus, the 
formats 1,10,20,30, and 1,10,+10,+10 are 
considered identical. 

If the name of a file is given, tabs reads 
the first line of the file, searching for a 
format specification (see fspec(F)). If it 
finds one there, it sets the tab stops ac- 
cording to it, otherwise it sets them as 
-8. This type of specification may be used 
to make sure that a tabbed file is printed 
with correct tab settings, and would be 
used with the pr(C) command as follows: 

tabs --file; pr file 

Any of the following also may be used; if a given flag 
occurs more than once, the last value given takes effect: 

-Ttype Tabs usually needs to know the type of ter- 

minal in order to set tabs and always needs 
to know the type to set margins. Type is a 
name listed in term(M). If no -T flag is 
supplied, tabs uses the value of the en- 
vironment variable TERM. If TERM is not 
defined in the environment (see 
environ(M)), tabs tries a sequence that 
will work for many terminals. 

+mn The margin argument may be used for some 

terminals. It causes all tabs to be moved 
over n columns by making column n+1 the 
left margin. If +m is given without a 
value of n, the value assumed is 10. For a 
TermiNet, the first value in the tab list 
should be 1, or the margin will move even 
further to the right. The normal 
(leftmost) margin on most terminals is ob- 



nl,n2,... 



-file 



3 



TABS(C) 



TABS(C) 



tained by +mO. The margin for most termi- 
nals is reset only when the +m flag is 
given explicitly. 

Tab and margin setting is performed via the standard out- 
put. 



Examples 



tabs -a Example using -code {canned specification) 

to set tabs to the settings required by the 
IBM assembler: columns 1, 10, 16, 36, 72. 



tabs -8 Example of using -n (repetitive specifi- 

cation), where n is 8, causes tabs to be 
set every eighth position: 1+(1*8), 
l+(2*8),... which evaluate to columns 9, 
17,... 



tabs 1,8,36 Example of using nJ,n2,... (arbitrary 

specification) to set tabs at columns 1, 8, 
and 36. 



tabs ~$HOME/fspec.llst/att4425 

Example of using -file (file specification) 
to indicate that tabs should be set accord- 
ing to the first line of 
$HOME/fspec.list/att4425 (see fspec(F)). 



. Diagnostics 

illegal tabs Arbitrary tabs were ordered incor- 

rectly. 

illegal increment A zero or missing increment is found 
in an arbitrary specification. 

unknown tab code A canned code cannot be found. 

can't open The —file option was used, and file 

can't be opened. 
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file indirection The —file option was used and the 

specification in that file points to 
yet another file. Indirection of this 
form is not permitted. 



See Also 



pr(C), environ(M), term(M), terminfo(M), and fspec(F) in 
the Reference (CP, S, F) 



Notes 

There is no consistency among different terminals regard- 
ing ways of clearing tabs and setting the left margin. 

Tabs clears only 20 tabs (on terminals requiring a long 
sequence), but is willing to set 64. 
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Name 

tail - Delivers the last part of a file. 



Syntax 

taU [ *[number ][ Ibc ] [ -f ] ] [ file ] 



Description 

TaU copies the named file to the standard output begin- 
ning at a designated place. If no file is named, the 
standard input is used. 

Copying begins at distance +number from the beginning, or 
-number from the end of the input (if number is null, the 
value 10 is assumed). Number is counted in units of 
lines, blocks, or characters, according to the appended 
option, 1, b, or c. When no units are specified, counting 
is by lines. 

With the -f (follow) option, if the input file is not a 
pipe, the program will not terminate after the line of the 
input file has been copied, but it will enter an endless 
loop. In this loop, the program sleeps for a second and 
then attempts to read and copy further records from the 
input file. Thus, it may be used to monitor the growth of 
a file that is being written by some other process. For 
example, the command: 

taU -f terry 

will print the last ten lines of the file, terry, followed 
by any lines that are appended to file between the time 
taU is initiated and killed. As another example, the 
command: 

taU -15cf terry 

will print the last 15 characters of the file terry, fol- 
lowed by any lines that are appended between the time taU 
is initiated and killed. 
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See Also 
dd(C) 



Notes 

Tails relative to the end of the file are kept in a buf- 
fer, and thus are limited in length. Unpredictable re- 
sults can occur if character special files are "tailed." 
The tail command will only tail at most the last 4096 
bytes of a file regardless of its line count unless the b 
option is used. 
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Name 



tapeutil - Utility program for a streaming tape drive. 

* Syntax 

tapeutil [-e] [-r] ... 



Description 

If you invoke tapeutil without any arguments, the tape 
operations are selected using an interactive menu. If you 
specify command line options, the corresponding tape oper- 
ation will be performed non-interactively once for each 
occurrence of the option. Unknown options are ignored. 



Options 

-e Erases the tape once, 
-r Retensions the tape once. 

It is recommended that you erase the tape before each 
archive (C) operation. If the tape does not stream when 
using archive, retensioning and erasing the tape will 
usually remedy this problem. 



Related Commands 



archive (C) 



Examples 

To retension the tape twice and erase it once, type: 
tapeutil -r -r -e B'/dRW 
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Name 

tar - Copies files to and from the hard disk to tape or 
floppy disk. 



Syntax 

tar [crtux] [bBefFilhklmnopsvVw 0,...,7] [arguments] 
file ... 



Description 

The tar command saves and restores files on magnetic tape 
or floppy disk. Tar's actions are controlled by a key 
argument, which contains at least one function letter fol- 
lowed by one or more function modifiers. Other arguments 
to the command are file or directory names specifying 
which files are to be dumped or restored. In all cases, a 
directory name refers to the files and (recursively) sub- 
directories of that directory. 

Tar permits a file to extend across media boundaries. 

Specify the function portion of the key by one of the fol- 
lowing letters: 

c Creates a new tape; writing begins at the beginning 
of the tape instead of after the last file. When you 
use this command, all previous data is erased. 

r Writes the named files at the end of the tape (only 
for seekable devices). 

t Lists the named file each time it occurs on the tape. 
If no file argument is given, all of the names on the 
tape are listed. 

u Adds the named file to the tape if it is not already 
there or if it has been modified since last put on 
the tape. This option can be slow (only for seekable 
devices). 
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X Extracts the named file from the tape. If the named 
file matches a directory whose contents have been 
written on the tape, this directory is (recursively) 
extracted. The owner and mode are restored (if 
^ possible). If no file argument is given, the entire 

^ content of the tape or floppy is extracted. If mul- 

tiple entries specifying the same file are on the 
tape, the last version will overwrite all preceding 
versions. 

In addition to the key argument function, you can use the 
following modifiers. Arguments to the modifiers are given 
in the same order as the modifiers themselves. 

b Causes tar to use the next argument as the blocking 
factor for tape records. The default is 18 (a maxi- 
mum of 1024 for the 386 series). Use the same block- 
ing factor on the x (extract) as used on the c 
(create) option. 

This option should only be used with raw magnetic 
tape archives (see f below). 

^ Don't use the b option with archives that are going 

^ to be updated. If the archive is on a disk file, the 

b option should not be used at all, as updating an 
archive stored in this manner can destroy it. 

B Archives all files modified after the modification 
date and time of the file you specify (instead of 
/etc/bkupdate). 

Can only be used with the I option. Also tar sets 
the modification time of the given file after the 
backup is complete. The B option sets the modifica- 
tion time in the user-specified file. For example: 

tar cvfbBI /dev/rct 1024 /etc/timefile ./* 

The user-specified file is set to zero length when 
its modification date is set. 

6 Prevents files from being split across volumes (tapes 
or disks). If there is not enough room on the pre- 
sent volume for a given file, tar prompts for a new 
volume. This is only valid when you also specify the 
k option. 



2 



TAR(C) 



TAR(C) 



f Causes tar to use the next argument as the name of 
the archive instead of /dev/tar. If the name of the 
file is tar writes to standard output or reads 
from standard input, whichever is appropriate. Thus, 
you can use tar to move hierarchies with the command 

cd fromdir; tar cf - . | (cd todir; tar xf -) 

You must use this option with magnetic tape and 
add-on hard disks. The default is to floppy disk. 

F Causes tar to use the next argument as the name of a 
file from which succeeding arguments are taken. A 
dash (-) signifies that arguments are taken from the 
standard input. 

h Archives the contents of the sjmibolically-linked 
named files. Tar cv will only archive linkage in- 
formation; tar chv will archive the contents. 

i date time 

Archives all files modified after date and time. The 
format for date and time is: 

MM/DD/YYyHH:MIN:SEC 

Files modified before date and time will be skipped. 
Any trailing portion may be omitted. DD, HH, MIN 
default to 0; YY defaults to the current year. For 
example: 

tar evif 12/22/86,04:00:00 /dev/rct files 

I Archives all files modified after the date and time 
as defined by the modification time of the file 
/etc/bkupdate. Also, sets the modification time of 
/etc/bkupdate after the backup is complete. To use a 
different file, see the B option. 

k Causes tar to use the next argument as the size of an 
archive volume in kilobytes. The minimum value al- 
lowed is 250. This value must be a multiple of the 
blocking factor (9K by default). For tape, you can 
specify the block size using the b option. Very 
large files are split into "extents" across volumes. 
When restoring from a multivolume archive, tar only 
prompts for a new volume if a split file has been 
partially restored. 



3 



TAR(C) 



TAR(C) 



1 Tells tar to notify you if the link count of a dumped 
file doesn't match the actual number of dumped links 
to that file. If this option is not specified, no 
error messages are printed. 

m Tells tar not to restore the modification time; the 
time of extraction then becomes the modification 
time. 



n Indicates the archive device is not a magnetic tape. 
The k option implies this. Because it can seek over 
files it wishes to skip, tar can quickly list and 
extract the contents of an archive. Sizes are 
printed in kilobytes instead of tape blocks. 

o Causes extracted files to take on the user /group 
identifier of the user running the program, rather 
than those on the tape. 

p Indicates that files are extracted using their orig- 
inal permissions. It is possible that a regular user 
may be unable to extract files because of the permis- 
sion associated with the files or directories being 
extracted. 

s file 

Runs the /bin/sum algorithm on the archive and writes 
the resulting checksum in file. 



V Displays the name of each file it treats preceded by 
the function letter. With the t function, v gives 
more information about the tape entries than just the 
name and path. 

V Verifies the named file on the tape. Tar will com- 
pare the tape file to the disk file and report any 
file change or comparison errors. If no file argu- 
ment is given, the entire contents of the tape or 
floppy is verified. Tar will exit with an exit code 
of 9 if there are any verify errors. 

w Causes tar to display the action to be taken and file 
name, then wait for user confirmation. If you type 
y, the action is performed. Any other input causes 
the file to be skipped. 
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0,...,7 

Selects the drive on which the archive is mounted. 
This option should only be selected if you have 
linked the appropriate /dev/mt to the desired device. 

The floppy devices supported are: 



floppy 


tracks/ 


double or 


sectors/ 


size 




device 


inch 


single sided 


track 


(bytes) 


sector 


fd096asl5 


96 


double 


15 


1. 15M 


2300 


fd096ds9 (default) 


96 


double 


9 


720K 


1440 


fd048ds9 


48 


double 


9 


360K 


720 


fd048ds8 


48 


double 


8 


320K 


640 


fd048ss9 


48 


single 


9 


180K 


360 


fd048ss8 


48 


single 


8 


160K 


320 



Files 



/dev/tar Default input/output device 

/tmp/tar* 



Examples 



This command copies the directory /usr/john to floppy 
disk(s). 

tar cv /usr/john lir/iiiW 

This command copies the files on the floppy disk to the 
directory /usr/john. The cd command is used first to make 
sure you are in the correct directory. 



ed /u sr/john 
tar XV 



Retn 



Retn 



This command displays the contents of the floppy disk you 
have in the drive. 

tar tv BSSSI 
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This command pipes the tar tv command through the Ipr 
command. This causes the contents of the floppy disk to 
be printed out on your serial printer. 

tar tv 

This command copies files from a floppy disk device named 
/dev/fd096dsl5 {files are the names of files to archive, 
and 1152 is the capacity of the disk in kilobytes). Argu- 
ments to key letters are given in the same order as the 
key letters themselves, thus the fk key letters have cor- 
responding arguments /dev/fd096dsl5 and 1152. If a file 
is a directory, the contents of the directory are recur- 
sively archived. 

tar cvfk /dev/fd096dsl5 1152 files BaSBl 

This command extracts all the files with the exact same 
pathnames used when the archive was created. 

tar xvf /dev/fd096dsl5 ■fRBM 

This command copies the directory /usr/john to cartridge 
tape(s). 

tar cvfb /dev/ret 126 /usr/john IrSW 



6 



TEE(C) 



TEE(C) 



Name 

tee - Creates a tee in a pipe. 
Syntax 

tee [ -a ] [ -i ] [ file ... ] 
Description 

Tee transcribes standard input to the standard output and 
makes copies in the files. The options are: 

-a Causes the output to be appended to the files rather 
than overwriting them. 

-i Ignores interrupts. 
Examples 

The following example illustrates the creation of tempo- 
rary files at each stage in a pipeline: 

grep ABC file \ tee ABC.grep | sort | tee ABC. sort | more 

This example shows how to tee output to the terminal 
screen: 

grep ABC file \ tee /dev/tty | sort | uniq >final.file 
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Name 

test - Evaluates an expression. 



Syntax 

test expT 
[ expr ] 



Description 

Test evaluates the expression expr and, if its value is 
true, returns a zero (true) exit status; otherwise, a 
non-zero (false) exit status is returned; test also sets a 
non-zero exit status if there are no arguments. When per- 
missions are tested, the effective user ID of the process 
is used. 

All operators, flags, and brackets (brackets used as shown 
in the second Sjmtax line) must be separate arguments to 
the test command; normally these items are separated by 
\ spaces. 



The following primitives are used to construct expr: 



-r file 


True if 


file 


exists 


and 


is 


readable. 


-w file 


True if 


file 


exists 


and 


is 


writable. 


-X file 


True if 


file 


exists 


and 


is 


executable. 


-f file 


True if 


file 


exists 


and 


is 


a regular file. 


-d file 


True if 


file 


exists 


and 


is 


a directory. 


-c file 


True if 
special 


file 
file. 


exists 


and 


is 


a character 


-b file 


True if 
file. 


file 


exists 


and 


is 


a block special 


-p file 


True if 
(fifo). 


file 


exists 


and 


is 


a named pipe 
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-u file True if file exists and its set-user-ID bit 

is set. 

-g fUe True if file exists and its set-group-ID 

bit is set. 

-k file True if file exists and its sticky bit is 

set. 

-s file True if file exists and has a size greater 

than zero. 

-t [fildes] True if the open file whose file descriptor 

number is fildes (1 by default) is 
associated with a terminal device. 

-z si True if the length of string si is zero. 

-n si True if the length of the string si is 

non-zero. 

si = s2 True if strings si and s2 are identical. 

si 1= s2 True if strings si and s2 are not 

identical. 

si True if si is not the null string. 

nl -eq n2 True if the integers nl and n2 are 

algebraically equal. Any of the compari- 
sons -ne, -gt, -ge, -It, and -le may be 
used in place of -eq. 

These primaries may be combined with the following opera- 
tors: 

! Unary negation operator. 

-a Binary and operator. 

-o Binary or operator (-a has higher prece- 

dence than -o). 

(expr) Parentheses for grouping. Notice also that 

parentheses are meaningful to the shell 
and, therefore, must be quoted. 
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See Also 

find(C), sh(C) 



Notes 

If you test a file you own (the -r, -w, or -x tests), but 
the permission tested does not have the owner bit set, a 
non-zero (false) exit status will be returned even though 
the file may have the group or other bit set for that per- 
mission. The correct exit status will be set if you are 
super-user. 

The = and != operators have a higher precedence than the 
-r through -n operators, and = and 1= always expect argu- 
ments; therefore, = and != cannot be used with the -r 
through -n operators. 

If more than one argument follows the -r through -n opera- 
tors, only the first argument is examined; the others are 
ignored, unless a -a or a -o is the second argument. 
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Name 

tic - Compiles terminfo source. 



Syntax 

tic [-v[n]] [-C] file 



Description 

Tic translates a tenninfo(M) file from the source format 
into the compiled format. The results are placed in the 
directory /usr/lib/terminfo. The compiled format is ne- 
cessary for use with the library routines described in 
curses(S). 

-vn Output (verbose) to standard error trace infor- 

mation showing tic's progress. The optional 
integer n is a number from 1 to 10, inclusive, 
indicating the desired level of detail of infor- 
mation. If n is omitted, the default level is 
1. If n is specified and greater than 1, the 
level of detail is increased. 

-c Only check file for errors. Errors in use= 

links are not detected. 

file Contains one or more terminfo(M) terminal de- 

scriptions in source format (see terminfo(M)). 
Each description in the file describes the capa- 
bilities of a particular terminal. When a 
\ise=entry-name field is discovered in a terminal 
entry currently being compiled, tic reads in the 
binary from usr/lib/terminfo to complete the 
entry. (Entries created from file will be used 
first. If the environment variable TERMINFO is 
set, that directory is searched instead of 
/usr/lib/terminfo. ) 

Tic duplicates the capabilities in entry-name 
for the current entry, with the exception of 
those capabilites that explicitly are defined in 
the current entry. 

If the environment variable TERMINFO is set, the compiled 
results are placed there instead of /usr/lib/terminfo. 
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Files 



/usr/lib/terminfo/?/* Compiled terminal description 

data base 



See Also 



terminfo(M), term(M) and curses(S) in the Reference 
(CP, S, F) 



Notes 

Total compiled entries cannot exceed 4096 bytes. The name 
field cannot exceed 128 bytes. 

Terminal names exceeding 14 characters will be truncated 
to 14 characters and a warning message will be printed. 

When the -c option is used, duplicate terminal names will 
not be diagnosed; however, when -c is not used, they will 
be. 

To allow existing executables from the previous release of 
the UNIX System to continue to run with the compiled 
termlnfo entries created by the new terminfo compiler, 
cancelled capabilities will not be marked as cancelled 
within the terminfo binary unless the entry name has a '+' 
within it. (Such terminal names are only used for inclu- 
sion within other entries via a use= entry. Such names 
would not be used for real terminal names.) 

For example: 

4415+nl, kfie, kf2@, . . . 

4415+base, kfl=\EOc, kf2=\E0d, . . . 

4415-nl 4415 terminal without keys, 
use=4415+nl, use=4415+base. 

The above example works as expected; the definitions for 
the keys do not show up in the 4415-nl entry. However, if 
the entry 4415+nl did not have a plus sign within its 
name, the cancellations would not be marked within the 
compiled file and the definitions for the function keys 
would not be cancelled within 4415-nl. 
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Diagnostics 

Most diagnostic messages produced by tic during the com- 
pilation of the source file are preceded with the approxi- 
mate line number and the name of the terminal currently 
being worked on. 

mkdir ... returned bad status 

The named directory could not be created. 

File does not start with terminal names in column one 
The first thing seen in the file, after comments, 
must be the list of terminal names. 

Token after a seek not NAMES 

Somehow the file being compiled changed during the 
compilation. 

Not enough memory for use_list element 
or 

Out of memory 

Not enough free memory was available (malloc(S) 
failed). 

Can't open ... 

The named file could not be created. 

Error in writing ... 

The named file could not be written to. 

Can't link ... to ... 
A link failed. 

Error in re-reading compiled ... 

The compiled file could not be read back in. 

Premature EOF 

The current entry ended prematurely. 

Backspaced off beginning of line 

This error indicates something wrong happened within 
tic. 

Unknown Capability - 

The named invalid capability was found within the 
file. 
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Wrong type used for capability 

For example, a string capability was given a numeric 
value. 

^j Unknown token type 

^' Tokens must be followed by '@' to cancel, ',' for 

booleans, for numbers, or for strings. 

bad term name 
or 

Line Illegal terminal name - 

Terminal names must start with a letter or digit 
The given name was invalid. Names must not contain 
white space or slashes, and must begin with a letter 
or digit. 

terminal name too long. 

An extremely long terminal name was found. 

terminal name too short. 

A one-letter name was found. 

filename too long, truncating to 

The given name was truncated to 14 characters due to 
the operating system file name length limitations. 

defined in more than one entry. Entry being used is 

II 11 

An entry was found more than once. 

Terminal name synonym for itself 

A name was listed twice in the list of synonyms. 

At least one synonym should begin with a letter. 

At least one of the names of the terminal should 
begin with a letter. 

Illegal character - 

The given invalid character was found in the input 
file. 

Newline in middle of terminal name 

The trailing comma was probably left off of the list 
of names. 

Missing comma 

A comma was missing. 
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Missing numeric value 

The number was missing after a numeric capability. 

NULL string value 

The proper way to say that a string capability does 
not exist is to cancel it. 

Very long string found. Missing comma? 
Self-explanatory 

Unknown option. Usage is; 

An invalid option was entered. 

Too many file names. Usage is: 
Self-explanatory 

non-existent or permission denied 

The given directory could not be written into. 

is not a directory 
Self-explanatory 

Permission denied 
Access denied. 

Not a directory 

Tic wanted to use the given name as a directory, but 
it already exists as a file 

SYSTEM ERRORIl Fork failedlH 
A fork(S) failed. 

Error in following up use-links. Either there is a loop 
in the links or they reference non-existant terminals. 
The following is a list of the entries involved: 

A terminfo(M) entry with a use=namc capability either 
referenced a non-existant terminal called name or 
name somehow referred back to the given entry. 
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Name 

time - Times a command. 

Syntax 

time command 

Description 

The given command is executed. After it is complete, time 
prints the elapsed time during the command, the time spent 
in the system, and the time spent in execution of the com- 
mand. Times are reported in seconds. 

The times are printed on the standard error output. 

See Also 

times(S) 
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Name 

tk - Paginator for the Tektronix 4014. 



Synt£ix 

tk [ -IV ] [ -pL ] [ -t ] [ file ] 



Description 

The output of tk is intended for a Tektronix 4014 termi- 
nal. Tk arranges for 66 lines to fit on the screen, di- 
vides the screen into N columns, and contributes an eight 
space page offset in the (default) single-column case. 
Tabs, spaces, and backspaces are collected and plotted. 
At the end of each page, tk waits for a newline (empty 
line) from the keyboard before continuing on to the next 
page. In this wait state, the- command "Icommand" will 
send the command to the shell. 

The command line options are: 

-N Divide the screen into JV columns and wait after the 
last column. 

-pL Set page length to L lines. 

-t Don't wait between pages (for directing output to a 
file). 



See Also 
pr(C) 
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Name 

touch - Updates access and modification times of a file. 
^ Syntax 

touch [ -amc ] [ mmddhhmm[yy] ] file ... 



Description 

Touch causes the access and modification times of each 
argument to be updated. If no time is specified (see 
date(C)) the current time is used. 

-a Causes touch to update only the access time (default 
is -am). 

-c Silently prevents touch from creating the file if it 
did not previously exist. 

-m Updates only the modification time (default is -am). 

The return code from touch is the number of files for 
which the times could not be successfully modified 
(including files that did not exist and were not created). 



See Also 

date(C), settime(C) and utime(S) in the Reference 
(CP, S, F) 



1 



TPUT(C) 



TPUT(C) 



Name 

tput - Queries terminfo database. 

Syntax 

tput [-Ttype] capname 

Description 

The tput command uses the terminfo(M) database to make 
terminal-dependent capabilities and information available 
to the shell. This command outputs a string if the attri- 
bute (capability name) is of type string, or an integer if 
the attribute is of type integer. If the attribute is of 
type boolean, tput simply sets the exit code (0 for TRUE, 
1 for FALSE), and produces no output. 

-ittype Indicates the type of terminal. Normally this 
flag isis unnecessary, as the default is taken 
from the environment variable TERM. 

capname Indicates the attribute from the terminfo data- 
base. (See terminfo(M).) 

Examples 

This command echoes a clear-screen sequence for the cur- 
rent terminal. 

tput clear 

This conmiand prints the number of columns for the current 
terminal. 

tput cols 

This command prints the number of columns for the 450 ter- 
minal. 

tput -T450 cols KSjsni 
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This command sets the shell variable "bold" to stand-out 
mode sequence for the current terminal. 

bold='tput smso* |^Q3 

This might be followed by a prompt: 

ec}iD ''^{bo].^) Please type ypq name: \c" 



This command sets the exit code to indicate if the current 
terminal is a hardcopy terminal. 



tput he 



Files 

/usr/lib/terminfo/?/* Terminal descriptor files 

/usr/include/term.h Definition files 

/usr /include/curses, h 
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Name 

tr - Translates characters. 



Syntax 

tr [ -cds 1 [ stringl [ string2 ] ] 



Description 

Tr copies the standard input to the standard output with 
substitution or deletion of selected characters. Input 
characters found in stnngl are mapped into the corres- 
ponding characters of string2. Any combination of the 
-cds options may be used; 

-c Complements the set of characters in stringl 

with respect to the universe of characters whose 
ASCII codes are 001 through 377 octal. 

-d Deletes all input characters in stringl. 

-s Squeezes all strings of repeated output charac- 

ters that are in string2 to single characters. 

The following abbreviation conventions may be used to in- 
troduce ranges of characters or repeated characters into 
the strings: 

[a-z] Stands for the string of characters whose 

ASCII codes run from character a to character 
z, inclusive. 

[a*n] Stands for n repetitions of a. If the first 
digit of n is 0, n is considered octal; other- 
wise, n is taken to be decimal. A zero or mis- 
sing n is taken to be huge; this facility is 
useful for padding string2. 

The escape character, \, may be used in the shell to re- 
move special meaning from any character in a string. 
Also, a \ followed by 1, 2, or 3 octal digits stands for 
the character whose ASCII code is given by those digits. 
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The following example creates a list of all the words in 
filel one per line in /i7e2, where a word is taken to be a 
maximal string of alphabetics. The strings are quoted to 
protect the special characters from interpretation by the 

\ shell; 012 is the ASCII code for newline: 

r 

tr -cs "[A-Z][a-z]" "[\012*]" <filel >fUe2 



See Also 

ascii(M), ed(C), sh(C) 



Notes 

Tr won't handle ASCII NUL in string 1 or string2; always 
deletes NUL from input. 
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Name 

tra - Copies out a file as it grows. 



Syntax 

tra [ - ] [ -interval ] [ +limit ] file 



Description 

Tra will copy out the contents of a growing file to the 
standard output as it grows. It alternately copies out 
the new material in the file and sleeps for interval 
seconds; the default interval is 15 seconds. Limit can be 
given to limit the total running time of the tra; the de- 
fault is effectively infinite. 

Tra normally copies out all the text currently in file 
before beginning to watch for new text. The option "-" 
alone causes only new material to be copied out. 

Tra is particularly useful for alternately watching the 
output file being written by a long shell script or a 
long-running program and doing real work. 



See Also 
tail(C) 
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Name 

true - Returns with a zero exit value. 

) 

Syntax 

true 

Description 

The true command returns with a zero exit value. False, 
true's counterpart, returns a non-zero exit value. True 
is typically used in shell procedures such as: 

while true 
do 

command 

done 

Related Commands 
sh(C), false(C) 
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Name 

tset - Sets terminal modes. 



Syntax 

tset [ - ] [-eEhkrsIQS] [ -m [ident][test baudratejztype] 
[type] 



Description 

The tset command causes terminal-dependent processing such 
as setting erase and kill characters or setting and reset- 
ting delays. It is driven by the /etc/ttytype and 
/usr/lib/terminfo/* files. 

Ports for which the terminal type is indeterminate are 
identified in /etc/ttytype as dialup, plugboard, etc. The 
port name is determined by a ttyname call on the diagnos- 
tic output. If the port is not found in /etc/ttytype the 
terminal type is set to unknown. 



Options 

Prints the terminal type on the standard output; this 
can be used to get the terminal type by saying: 

set termtype = "tset 

If no other options are given, tset operates in "fast 
mode" and only outputs the terminal tj^pe, bypassing 
all other processing. 

-ec Sets the erase character to be the character c on all 
terminals. To override this option, enter -e#. The 
default for c is the ba ckspace character on the ter- 
minal, usually KWiaBSB . 

-Ec Operates only on terminals that can backspace (same 
as -e). 

-h Forces tset to search /etc/ttytype for information, 
and to overlook the environment variable, TERM. 
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-I Suppresses outputting the terminal initialization 
strings. 



-kc Sets the kill character to c (QQSOS is the default 
h for c). No kill processing is done if -k is not spe- 

^ cified. In all of these fla gs, ""X" (where X is any 

character) is equivalent to KWiapm 



-m[ident][test baudrate]:type 

Allows you to specify how a given serial port is to 
be mapped to an actual terminal t5^e. The option 
applies to any serial port in /etc/ttytype whose type 
is indeterminate (e.g., dialup, plugboard, etc.). 
The type specifies the terminal type to be used and 
ident identifies the name of the indeterminate type 
to be matched. If no ident is given, all indetermi- 
nate types are matched. The test baudrate defines a 
test to be performed on the serial port before the 
type is assigned. The baudrate must be as defined in 
stty(C). The test may be any combination of: >, =, 
<, @, and !. 

If the type begins with a question mark, the system 
asks you if you really want that type. A null re- 
sponse means to use that type; otherwise, you can 
enter another type to be used instead. (The question 
mark must be escaped to prevent filename expansion by 
the shell.) 



-Q Suppresses the printing of the "Erase set to" and 
"Kill set to" messages. 

-r Prints the terminal type on the diagnostic output. 



-s Outputs the "setenv" commands (for csh(C)), or 

"export" and assignment commands (for sh(C)) as de- 
termined by user's login shell. 

-S Outputs only the strings to be placed in the environ- 
ment variables. 



Tset is most useful when included in the .login (for 
csh(C)) or .profile (for sh(C)) file executed automatical- 
ly at login, with -m mapping used to specify the terminal 
t57pe you most frequently dial in on. 
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Examples 



This command sets your terminal to the parameters con- 
tained under terminal type gt42 in your 
/usr/lib/terminfo/* file. 

tset gt42 

This conmiand sets the terminal parameters for an admSa 
terminal if a dialup line is used; otherwise, it prompts 
for the terminal type. 

tset -m dialup\>300:adm3a -m unknown:\? -e"Z -k'U 



where 
-m 

dialup 
\ 



mapping flag 
identifier 

tells the system to take the next character 
literally 



>300 speed of the baud rate test 

admSa terminal type 

unknown specifies "unknown" terminal type 



-e^Z 
-k^U 



tells the system to ask the user if he really 
wants that terminal type 

sets the erase character to mmnmrm 

sets the kill character to KwnBW 



To use the information created by the -s option for the 
Bourne shell, (sh(C)), repeat these commands: 

tset -s...> /tmp/tset$$ 

/tmp/tset$$ 

rm -f /tmp/tset$$ 
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To use the information for csh(C), use the following: 

set noglob 
^ set term=('tset -S....') 

^ setenv TERM $tenn[l] 

setenv TERMCAP ''$term[2]" 

unset term 

unset noglob 



Files 

/etc/ttytype Port name to terminal type map 

database 

/usr/lib/terminfo Terminal capability database 



See Also 

stty(C), ttys(M), termcap(M) 



Credit 

This utility was developed at the University of California 
at Berkeley and is used with permission. 
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Name 

tsort - Sorts a file topologically. 



Ssnitax 

tsort [ file ] 



Description 

Tsort produces on the standard output a totally ordered 
list of items consistent with a partial ordering of items 
mentioned in the input file. If no file is specified, the 
standard input is assumed. 

The input consists of pairs of items (nonempty strings) 
separated by blanks. Pairs of different items indicate 
ordering. Pairs of identical items indicate presence, but 
not ordering. 



See Also 

lorder(CP) in the Reference (CP, S, F) 



Diagnostics 

Odd data: There is an odd number of fields in the input 
file. 



Notes 

The sort algorithm is quadratic, which can be slow if you 
have a large input list. 
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Name 

tty - Gets the name of the terminal. 



Syntax 

tty [-1] [-S] 



Description 

Tty prints the path name of the user's terminal. The op- 
tions are: 

-1 Prints the sjmchronous line number to which the 
user's terminal is connected, if it is on an active 
synchronous line. 

-s Inhibits printing of the terminal path name, al- 
lowing one to test just the exit code. 

The exit code is: 

2 if invalid options were specified, 

0 if standard input is a terminal, 

1 otherwise. 



Diagnostics 

"not on an active synchronous line" if the standard input 
is not a synchronous terminal and -1 is specified. 

"not a tty" if the standard input is not a terminal and -s 
is not specified. 
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Name 

ua - User administration. 

Syntax 

ua [-h] 



Description 

You must be the super-user to access these commands. 

Use the ua conmiand for the addition, deletion, and modifi- 
cation of users and groups. It provides an effective 
means for maintaining the system password (/etc/passwd) 
and system group (/etc/group) files. 

The command is implemented using the termcap(M) and 
curses(S) facilities from UC Berkeley. It must be run 
interactively from a terminal defined in /etc/termcap. 



Options 



-h Displays the program's current version and copy- 

right notice as well as a short description of 
the program's functions. 

After you enter the command, ua displays its legal com- 
mands at the top of the screen. Select a conmiand and en- 
ter the first letter of the command at the "Command?" 
prompt at the bottom of the screen. Full command words 
are not acceptable as input. The case of each word is 
significant: "group" is not the same as "Group." 

The ua screen commands are summarized as follows: 



Add Adds a new user or group. After you specify the 

user or group and a new name, the system inmiedi- 
ately enters the change command to allow modifi- 
cation of the new entry. At the conclusion of 
the change command, the addition is made. If a 
directory already exists for a new user, it is 
not removed. All files under /etc/newuser are 
copied to the new directory during the user in- 
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stallation process. Typically, /etc/newuser 
will contain the standard versions of the fol- 
lowing files: .cshrc, .login, .logout, .profile. 

The initial value given to a new user ID is one 
more than the maximum user ID currently in use. 
The same is true for a new group ID. 

Delete Deletes an existing user or group. When you 
delete a user, the files and directories in that 
user's home directory will be deleted, but any 
other files owned by this user in the system 
will not be deleted. Thus, some files may have 
an "unknown" owner after a user is deleted. 
And, if a user is later added with the same user 
ID as the deleted user, these files will sud- 
denly belong to the new user. The same problem 
may arise with the deletion and later addition 
of a group. 



Show Shows an individual user or group or all users 
or groups. The word "show" may be omitted if 
desired. 



Change Modifies any existing user or group. When you 
select this command, a menu appears so you ca n 
select the it em to be modified. Typing ■roiCT o 
BiiiRMtfiSSB at a field change request empties th 
field. When you change a user or group, the 
corresponding entry in /etc/passwd is also 
changed. 



Changing a user's directory causes a renaming of 
that directory. Make sure that the entry in 
/etc/passwd remains consistent. 

If you want to move a user's directory from one 
file system to another, use cp -r to copy the 
user's directory to a new directory. 

Help Displays a short informative text on the screen, 

explaining each of the commands. "?" is equiva- 
lent to help. The message is the same one you 
get when you enter the ua command with the "-1 
option. 



Escapes to the shell (see the sh(C) command). 
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! Escapes to the shell (see the sh(C) command). 

If no arguments are given, a shell is invoked 
which will continue until it receives an 
end-of-file. Then ua resumes. If arguments are 
!^ present, a shell is invoked with the "-c" option 

^ and the arguments are passed along. Ua resumes 

immediately thereafter. 

Quit Immediately terminates ua and returns to the 

system. 

Any command that is not understood by ua causes an appro- 
priate error message to be displayed. As a side-effect, 
the working portion of the screen is cleared. 

The ua command does not distinguish between Bl^/38li^ and 

They may be used interchangeably. , 



Line ■ Feed 



If the screen becomes "dirty" for some reason, you can 
force ua to clear it and redisplay th e current contents by 
transmitting an ASCII DC2. This is TOiraBf on most ter- 
minals. 

The ua command understands the Backspace function (as ob- 
tained from /etc/termca p). I n addition, any time a word 
is partially formed, the KsBM key will cause the partial 
word to be discarded and input restarted. 



The ua command interprets the Cancel key to mean "ter mi- 
nate the current operation." The Cancel key is ■WiiPi'M 
on m ost te rminals. The Cancel key is more powerful 
than K5BB1. but not as powerful as "interrupt." 



The ua command will immediately return to the top-level 
command interpreter upon receipt of an inte rru pt signal . 
Such a signal is usually generated by Bsfl!{B\3i 



The ua conmiand creates a special user named "standard" in 
/etc/passwd if one is not already present. This entry is 
used as the template for installing new users. Thus, if 
you want all new users defaulted to the standard shell 
(/bin/sh) for the shell field, it is only necessary to 
update the shell field in the "standard" user. 

Before adding a new user with a new group, the new group 
should be added. Otherwise, ua has no way to properly 
create the new entry in /etc/passwd since it contains 
group numbers rather than group names. 
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During program initialization ua copies /etc/passwd and 
/etc/group to /etc/opasswd and /etc/ogroup, respectively. 
Thus, if a mistake or disaster occurs during the use of 
this program, the user may recover the prior state of 
either or both files. 



Files 



/etc/passwd Used for login name to user ID conversions 
/etc/group Used for group name to group ID conversion 
/etc/opasswd This file is a copy of /etc/passwd before 

any modifications are made 
/etc/ogroup This file is a copy of /etc/group before 

any modifications are made 
/etc/newuser Directory containing files which will be 

installed in a new user's account 
/etc/termcap Contains terminal attribute descriptions 
/tmp/passwd Temporary file 

/tmp/group Temporary file /etc/ua.lock lock file 



See Also 



group(M), passwd(M) 
Operations Guide 
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Name 

umask - Sets file-creation mode mask. 

Syntax 

umask [nnn] 

Description 

The user file-creation mode mask is set to nnn. The three 
octal digits refer to read/ write /execute permissions for 
owner, group, and others, respectively. Only the 
low-order 9 bits of cmask and the file mode creation mask 
are used. The value of each specified digit is 
"subtracted" from the corresponding "digit" specified by 
the system for the creation of any file (see the create 
files). This is actually a binary masking operation, and 
thus the name "umask." In general, binary ones remove a 
given permission and zeros have no effect at all. For 
example, umask 022 removes group and others write permis- 
sion (files normally created with mode 777 become mode 
755; files created with mode 666 become mode 644). 

If nnn is omitted, the current value of the mask is 
printed. 

Umask is recognized and executed by the shell. By de- 
fault, login shells have a umask of 022. 

Umask can be included in the user's .profile and invoked 
at login to automatically set the user's permissions on 
files or directories created. 



Related Commands 

chmode(C), sh(C), and chmod(S), creat(S), umask(S), 
profile(F) in the Reference (CP, S, F) 
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Name 

uname - Displays the current operating system information. 

\ 

*^ Syntax 

uname [ options ] 



Description 

The uname command displays the current operating system 
name on the standard output file. 



Options 

-a Displays all information on the screen 

-d Displays OEM (Distributor) for this system 

-h Displays the hardware machine name 

-i Displays an integer representing the machine type: 

1 = Altos 586/986 

2 = Altos 186 

3 = Altos 1086/2086 

6 = Altos 486 

7 = Altos 586T/986T 

8 = Altos 686/886 

9 = Altos 3086 

10 = Altos 386, Series 2000 

11 = Altos 386, Series 1000 

-m Displays original supplier (Manufacturer) of the sys- 
tem 

-n Displays the nodename (may be a name by which the 
system is known to a communications network) 

-r Displays the operating system release 

-s Displays the system name (default) 
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-S nodename 

Sets the name to nodename (for remote 
communications). The nodename is also written to the 
/etc/systemid file. You must be the super-user to 
use this option. Do not use -S to set the name if 
Worknet is running. 

-u Displays user serial number for this system 

-V Displays the operating system version number 



Files 

/etc/systemid Contains the name of sites as defined 

with the -N option (for compatibility 
with older programs). 
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Name 

uniq - Reports repeated lines in a file. 
Syntax 

uniq [ -cdu [ +n ] [ -n ] ] [ input [ output ] ] 



Description 

Uniq reads the input file and compares adjacent lines. In 
the normal case, the second and succeeding copies of re- 
peated lines are removed; the remainder is written on the 
output file. Input and output should always be different. 
Note that repeated lines must be adjacent in order to be 
found; see sort(C). The options are: 

-c Generates an output report in default style with each 
line preceded by a count of the number of times it 
occurred (supersedes the -u and -d options). 

-d Specifies that one copy of the repeated lines is to 
be written. The normal mode output is the union of 
the -u and -d mode outputs. 

-u Prints only the lines that are not repeated in the 
original file. 

The n arguments specify skipping an initial portion of 
each line in the comparison: 

-n The first n fields together with any blanks before 
each are ignored. A field is defined as a string of 
characters without spaces and tabs separated by 
spaces and tabs from adjacent fields. 

+n The first n characters are ignored. Fields are 
skipped before characters. 



See Also 

comm(C), sort(C) 
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Name 

units - Converts units. 



Sjmtax 

units 



Description 

Units converts quantities expressed in various standard 
scales to their equivalents in other scales. It works 
interactively in this fashion: 

You have: inch 
You want: cm 

* 2.540000e+00 
/ 3.937008e-01 

A quantity is specified as a multiplicative combination of 
units preceded optionally by a numeric multiplier. Powers 
are indicated by positive integer suffixes; division is 
indicated by the standard sign: 

You have: 15 lbs force/in2 
You want: atm 

* 1.020689e+00 
/ 9.797299e-01 

Units only does multiplicative scale changes; thus it can 
convert Kelvin to Rankine, but not Centigrade to Fahren- 
heit. Most familiar units, abbreviations, and metric pre- 
fixes are recognized, as well as the following: 



pi 


Ratio of circumference to diameter 


c 


Speed of light 


e 


Charge on an electron 


g 


Acceleration of gravity 


force 


Same as g 
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mole 



Avogadro's number 



water 



Pressure head per unit height of water 



au 



Astronomical unit 



Pound is not recognized as a unit of mass; lb is. Com- 
pound names are run together, (e.g., lightyear). British 
units that differ from their US counterparts are prefixed 
with "br". For a complete list of units, type: 

cat /usr/llb/unittab 



Files 



/usr/lib/unittab 
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Name 

upgrade, hd - Upgrades an additional hard disk. 



Syntax 

upgrade. hd [2] [3] 



Description 

The upgrade, hd command is a shell script that upgrades an 
additional hard disk if your system supports more than one 
add-on hard disk. You must be the super user to use this 
command. 

If you don't specify the number (i.e., 2 or 3) on the com- 
mand line, the script prompts you for the number. Once 
you reply with a correct number, the system updates the 
additional hard disk. 

Then upgrade, hd labels the hard disk drive and adds the 
mount entry command to the /etc/fstab file (so the add-on 
hard disk is mounted each time that the multiuser command 
is run). 

The directory used for the add-on hard disk is /usr2 for 
the second hard disk, /usr3 for the third hard disk, and 
so on. The add-on hard disk remains mounted as /usr2 
(/usrS) when upgrade. hd exits and whenever the system is 
in multiuser mode. 



Related Commands 

add.hd(M), add.hd(C), buildmap(C), sizefs(C) 
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Name 

UUCP, uulog, uuname - UNIX-to-UNIX system copy. 



Syntax 

UUCP [ options ] source-files destination-file 
uulog [ options ] -ssystem 
uulog [ options ] system 
uulog [ options ] -fsystem 
uuname [ -1 ] [ -c ] 



Description of uucp 

Uucp copies files named by the source-file arguments to 
the destination-file argument. A file name may be a path 
name on your machine, or may have the form: 

system-namelpath-name 

where system-name is taken from a list of system names 
that uucp knows about. The system-name may also be a list 
of names such as: 

system-namelsystem-namel..Asystem-namelpath-name 

in which case an attempt is made to send the file via the 
specified route, to the destination. See the "Notes" sec- 
tion that follows for restrictions. Care should be taken 
to ensure that intermediate nodes in the route are willing 
to forward information. 

The shell metacharacters ?, * and [...] appearing in 
path-name will be expanded on the appropriate system. 

Path names may be one of: 

• A full path name 

• A path name preceded by 'user where user is a login 
name on the specified system and is replaced by that 
user's login directory 
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• A path name preceded by ' /destination where destina- 
tion is appended to /usr/spool/uucppublic. NOTE: 
This destination will be treated as a file name un- 
less more than one file is being transferred by this 
request or the destination is already a directory. 

To ensure that it is a directory, follow the destina- 
tion with a '/'. For example, ~/dan/ as the destina- 
tion will make the directory 
/usr/spool/uucppublic/dan if it does not exist and 
put the requested file(s) in that directory 

• Anything else is prefixed by the current directory 

If the result is an erroneous path name for the remote 
system, the copy will fail. If the destination-file is a 
directory, the last part of the source-file name is used. 

Uucp preserves execute permissions across the transmission 
and gives 0666 read and write permissions (see chmod(C)). 

The following options are interpreted by uucp: 

-c Do not copy local file to the spool directory 

for transfer to the remote machine (default). 



-C Force the copy of local files to the spool di- 

rectory for transfer. 

-d Make all necessary directories for the file copy 

(default). 

-f Do not make intermediate directories for the 

file copy. 

SgTade Grade is a single letter/number; lower ascii 
sequence characters will cause the job to be 
transmitted earlier during a particular conver- 
sation. 



-j Output the job identification ASCII string on 

the standard output. This job identification 
can be used by uustat to obtain the status or 
terminate a job. 

-m Send mail to the requester when the copy is com 

pleted. 
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-nuser 



Notify user on the remote system that a file was 
sent. 



-r 



Do not start the file transfer, just queue the 
job. 



-sfile 



Report status of the transfer to file. Note 
that the file must be a full path name. 



-xdebug level 



Produce debugging output on standard output. 
The debug level is a number between 0 and 9; 
higher numbers give more detailed information. 



Description of uulog 

Uulog queries a log file of uucp or uuxqt transactions in 
a file: 

/usr/spool/uucp/.Log/uucico/system 

or 

/usr/spool/uucp/.Log/uuxqt/system 

The options cause uulog to print logging information: 

-ss3;s Print information about file transfer work in- 
volving system sys. 

-f system Does a tail -f of the file transfer log for sys- 




-X 



Look in the uuxqt log file for the 
given system. 



-number 



Indicates that a tail command of 
number lines should be executed. 
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Description of uuname 

Uuname lists the names of systems known to uucp. The -c 
option returns the names of systems known to cu. (The two 
lists are the same, unless your machine is using different 
systems files for cu and uucp. See the Sysfiles file.) 
The -1 option returns the local system name. 



Files 

/usr/spool/uucp Spool directories 

/usr/spool/uucppublic/* Public directory for receiving 

and sending 
( /usr/spool/uucppublic) 
/usr/lib/uucp/* Other data and program files 



See Also 



mail(C), uustat(C), uux(C), uuxqt(M), chmod(C), uuto(C), 
uupick(C) 



Notes 

The domain of remotely accessible files can (and for ob- 
vious security reasons, usually should) be severely re- 
stricted. You will very likely not be able to fetch files 
by path name; ask a responsible person on the remote sys- 
tem to send them to you. For the same reasons you will 
probably not be able to send files to arbitrary path 
names. As distributed, the remotely accessible files are 
those whose names begin /usr/spool/uucppublic (equivalent 
to V). 

All files received by uucp will be owned by uucp. The -m 
option will only work sending files or receiving a single 
file. Receiving multiple files specified by special shell 
characters ? * [...] will not activate the -m option. 

The forwarding of files through other systems may not be 
compatible with the previous version of uucp. If forward- 
ing is used, all systems in the route must have the same 
version of uucp. 
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Protected files and files that are in protected direc- 
tories that are owned by the requestor can be sent by 
uucp. However, if the requestor is root, and the direc- 
tory is not searchable by "other" or the file is not read- 
able by "other", the request will fail. 

If you use the C-shell to execute uucp commands, be sure 
to escape any exclamation point (I) used on the conmiand 
line. 
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Name 

uustat - Uucp status inquiry and job control. 



Synt£ix 

uustat [-a] 

uustat [-m] 

uustat [-p] 

uustat [-q] 

uustat [ -kjobid ] 

uustat [ -rjobid ] 

uustat [ -ssystem ] [ -uuser ] 



Description 

Uustat will display the status of, or cancel, previously 
specified uucp commands, or provide general status on uucp 
connections to other systems. Only one of the following 
options can be specified with uustat per command execu- 
tion: 

-a Output all jobs in queue. 

-m Report the status of accessibility of all 

machines. 

-p Execute a ps -flp for all the process-ids that 

are in the lock files. 

-q List the jobs queued for each machine. If a 

status file exists for the machine, its date, 
time and status information are reported. In 
addition, if a number appears in () next to the 
number of C or X files, it is the age in days of 
the oldest C./X. file for that system. The 
Retry field represents the number of hours until 
the next possible call. The Count is the number 
of failure attempts. 



NOTE 

For systems with a moderate number of out- 
standing jobs, this could take 30 seconds or 
more of real-time to execute. 
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An example of the output produced by the -q op- 
tion is: 

eagle 3C 04/07-11:07 NO DEVICES AVAILABLE 

inh3bs3 2C 07/07-10:42 SUCCESSFUL 

The above output tells how many command files 
are waiting for each system. Each command file 
may have zero or more files to be sent (zero 
means to call the system and see if work is to 
be done). The date and time refer to the pre- 
vious interaction with the system followed by 
the status of the interaction. 

-kjobid Kill the uucp request whose job identification 
is jobid. The killed uucp request must belong 
to the person issuing the uustat command unless 
one is the super-user. 

-rjobid Rejuvenate jobid. The files associated with 
jobid are touched so that their modification 
time is set to the current time. This prevents 
the cleanup daemon from deleting the job until 
the jobs modification time reaches the limit 
imposed by the daemon. 

Either or both of the following options can be specified 
with uustat: 

-ssys Report the status of all uucp requests for re- 
mote system sys. 



-uuser Report the status 
user. 

Output for both the -s and 
format: 



of all uucp requests issued by 



-u options has the followmg 



eaglenOOOO 4/07-11:01:03 (POLL) 

eagleNlbd7 4/07-11:07 Seagledan522/usr/dan/A 

eagleClbdS 4/07-11:07 Seagledan59 D . 3b2al2ce4924 

4/07-11:07 Seagledanrmail mike 

With the above two options, the first field is the jobid 
of the job. This is followed by the date/time. The next 
field is either an 'S' or 'R' depending on whether the job 
is to send or request a file. This is followed by the 
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user-id of the user who queued the job. The next field 
contains the size of the file, or in the case of a remote 
execution (rmail - the command used for remote mail), the 
name of the command. When the size appears in this field, 
the file name is also given. This can either be the name 
given by the user or an internal name (e.g., 
D.3b2alce4924) that is created for data files associated 
with remote executions (rmail in this example). 

When no options are given, uustat outputs the status of 
all UUCP requests issued by the current user. 



Files 

/usr/spool/uucp/* Spool directories 



See Also 

uucp(C) 
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Name 

uuto, uupick - Public UNIX-to-UNIX system file copy. 
Syntax 

uuto [ options ] source-files destination 
uupick [ -s system ] 



Description 

Uuto sends source-files to destination. Uuto uses the 
uucp(C) facility to send files, while it allows the local 
system to control the file access. A source-file name is 
a path name on your machine. Destination has the form: 

systemluser 

where system is taken from a list of system names that 
UUCP knows about (see uuname(C)). User is the login name 
of someone on the specified system. 

Two options are available: 

-p Copy the source file into the spool directory before 
transmission. 

-m Send mail to the sender when the copy is complete. 

The files (or sub- trees if directories are specified) are 
sent to PUBDIR on system, where PUBDIR is a public direc- 
tory defined in the uucp source. By default this direc- 
tory is /usr/spool/uucppublic. Specifically the files are 
sent to: 

PUBDIR/receive/user/mysystem//ncs 

The destined recipient is notified by mail(C) of the ar- 
rival of files. 
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Uupick accepts or rejects the files transmitted to the 
user. Specifically, uupick searches PUBDIR for files des- 
tined for the user. For each entry (file or directory) 
found, the following message is printed on the standard 
output: 

from system: [file file-name] [dir dirname] ? 

Uupick then reads a line from the standard input to deter- 
mine the disposition of the file: 

Go on to next entry. 

Delete the entry. 

Move the entry to named directory dir. If 
dir is not specified as a complete path 
name (in which $HOME is legitimate), a des- 
tination relative to the current directory 
is assumed. If no destination is given, 
the default is the current directory. 

a [ dir ] Same as m except moving all the files sent 

from system. 

Print the content of the file. 

Stop. 

) Same as q. 

Escape to the shell to do command, 

* Print a conmiand summary. 

Uupick when invoked with the -ssystem option will only 
search the PUBDIR for files sent from system. 

Files 

PUBDIR /usr/spool/uucppublic Public directory 
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See Also 

mail(C), uucp(C), uustat(C), uux(C), uucleanup(M) 



Notes 

In order to send files that begin with a dot (e.g., 
.profile) the files must by qualified with a dot. For 
example: .profile, .prof*, .profil? are correct; whereas 
*prof*, ?profile are incorrect. 

If you use the C-shell to execute uuto, be sure to escape 
any exclamation point (!) used on the command line. 
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Name 

uux - Executes a command on a remote UNIX system. 



Syntax 

uux [ options ] command-string 



Description 

Uux will gather zero or more files from various systems, 
execute a command on a specified system and then send 
standard output to a file on a specified system. 



NOTE 

For security reasons, most installations limit 
the list of commands executable on behalf of 
an incoming request from uux, permitting only 
the receipt of mail (see mail(C)). (Remote 
execution permissions are defined in 
/usr/lib/uucp/Permissions. ) 



The command-string is made up of one or more arguments 
that look like a shell command line, except that the com- 
mand and file names may be prefixed by system-namel. A 
null system-name is interpreted as the local system. 

File names may be one of: 

• A full path name 

• A path name preceded by ~xxx where xxx is a login 
name on the specified system and is replaced by that 
user's login directory 

• Anything else is prefixed by the current directory 
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As an example, the command: 

uux "!diff usg!/usr/dan/filel 
pwba!/a4/dan/f Ue2> I " /dan/f Ue. dif f " 

will get the filel and file2 files from the "usg" and 
"pwba" machines, execute a dlff(C) command and put the 
results in file. dif f in the local PUBDIR/dan/ directory. 

Any special shell characters such as < > ; | should be 
quoted either by quoting the entire command-stringf or 
quoting the special characters as individual arguments. 

Uux will attempt to get all files to the execution system. 

For files that are output files, the file name must be 
escaped using parentheses. For example, the command: 

uux a!cut -fl b!/usr/file \(c!/usr/file\) 

gets /usr/file from system "b" and sends it to system 
"a," performs a cut command on that file, and sends the 
result of the cut command to system "c." 

Uux will notify you if the requested command on the remote 
system was disallowed. This notification can be turned 
off by the -n option. The response comes by remote mail 
from the remote machine. 

The following options are interpreted by uux: 

The standard input to uux is made the standard 
input to the command-string, 

-aname Use name as the user identification replacing 
the initiator user ID. (Notification will be 
returned to the user.) 

-b Return whatever standard input was provided to 

the uux command if the exit status is non-zero. 

-c Do not copy local file to the spool directory 

for transfer to the remote machine (default). 

-C Force the copy of local files to the spool di- 

rectory for transfer. 
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-ggrade Grade is a single letter/number; lower ASCII 
sequence characters will cause the job to be 
transmitted earlier during a particular conver- 
sation. 

-j Output the jobid ASCII string on the standard 

output which is the job identification. This 
job identification can be used by uustat to ob- 
tain the status or terminate a job. 

-n Do not notify the user if the command fails. 

-p Same as -: The standard input to uux is made 

the standard input to the command-string. 

-r Do not start the file transfer, just queue the 

job. 

-sfile Report status of the transfer in file. 

-xdebuglevel 

Produce debugging output on the standard output. 
The debug Jevel is a number between 0 and 9; 
higher numbers give more detailed information. 

-z Send success notification to the user. 



Files 

/usr/lib/uucp/spool Spool directories 

/usr/lib/uucp/Permissions Remote execution permissions 

/usr/lib/uucp/* Other data and programs 



See Also 

mail(C), uucp(C), uustat(C) 



Notes 

Only the first command of a shell pipeline may have a 
system-namel. All other commands are executed on the sys- 
tem of the first conmiand. The use of the shell metachar- 
acter * will probably not do what you want it to do. The 
shell tokens « and » are not implemented. 
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The execution of commands on remote systems takes place 
in an execution directory known to the uucp system. All 
files required for the execution will be put into this 
directory unless they already reside on that machine. 
K Therefore, the simple file name (without path or machine 

^ reference) must be unique within the uux request. The 

following command will NOT work: 

uux "a!dlff b!/usr/dan/xyz c!/usr/dan/xyz>!xyz.diff" 
but the command: 

uux "aldiff a!/usr/dan/xyz c!/usr/dan/xyz > Ixyz.diff" 

will work. (If diff(C) is a permitted command.) 

Protected files and files that are in protected director- 
ies that are owned by the requestor can be sent in com- 
mands u using uux. However, if the requestor is root, and 
the directory is not searchable by "other," the request 
will fail. 

If you use the C-shell to execute uux, be sure to escape 
any exclamation point (!) used on the command line. 
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Name 

vi - Screen-oriented (visual) display editor based on ex. 



Synteix 

vi [ -t tag ] 
name,.. 

view [ -t tag ] 
name 

vedit [ -t fag ] 
name 



[ -r file ] [ -wn ] [ 
[ -r file ] [ -wn ] [ 
[ -r file ] [ -wn ] [ 



-R ] [ +command ] 
-R ] [ *command ] 
-R ] [ +command ] 



Description 

Vi (visual) is a display-oriented text editor based on an 
underlying line editor ex(C). It is possible to use the 
command mode of ex from within vi and vice-versa. 

When using vi, changes you make to the file are reflected 
in what you see on your terminal screen. The position of 
the cursor on the screen indicates the position within the 
file. Vi is explained in detail in the User's Guide. 



Invocation 

The following invocation options are interpreted by vi: 

-t tag Edit the file containing the tag and 

position the editor at its definition. 

-r file Recover file after an editor or system 

crash. If file is not specified a list of 
all saved files will be printed. 

-wn Set the default window size to n. This is 

useful when using the editor over a slow 
speed line. 

-R Read only mode; the readonly flag is set, 

preventing accidental overwriting of the 
file. 
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+command The specified ex command is interpreted 

before editing begins. 

The name argument indicates files to be edited. 

The view invocation is the same as vi except that the 
readonly flag is set. 

The vedit invocation is intended for beginners. The re- 
port flag is set to 1, and the showmode and novice flags 
are set. These defaults make it easier to get started 
learning the editor. 



Vi Modes 

Command 

Input 



Last line 



Normal and initial mode. Other modes re- 
turnto command mode upon completion. 
1^31 (escape) is used to cancel a partial 
command. 

Entered by the following options: a, i, A, 
I, o, O, c, C, s, S, and R. Arbitrary text 
may then be entered. Input mode is nor- 
mally terminated with or abnormally 
with (interrupt). 

Readi ng inpu t for : / ? or !; terminate 
with ■t^iiW to execute, interrupt to cancel. 



Special Keys 



There are several special keys in vi. These keys are used 
to edit, delimit, or abort commands and command lines. 



Esc Returns to vi command mode, cancels par- 

tially formed commands. 

Retn Terminates ex commands when in ex escape 

mode. Also used to start a new line when 
in insert mode. 



Interrupt Generates an interrupt, telling the editor 

to stop what it is doing. Aborts any com- 
man d that is executing. Often the same as 
the or Rubout key on many terminals. 
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I Specifies a string to be searched for. The 

slash appears on the status line as a 
prompt for a search string. The question 
mark (?) works exactly like the slash key, 
except that it searches backward in a file 
instead of forward. 

: Prompts for an ex command. You can then 

typ e any ex conmiand, followed by an KbBISI 
or BrfJjW . and the given ex command is 
executed. 

The following characters are special in Insert Mode: 

Backspace Backs up the cursor one character on the 
current line. The last character typed 
before the Backspace is removed from the 
input buffer, but remains displayed on the 
screen. 

Ctrl-u Moves the cursor back to the first charac- 

ter of the insertion, and restarts inser- 
tion. (This is actually the "kill" key; so 
it may be different on your system.) 



Ctrl-v Removes the special signific ance of the 

next typed character. Use ktii^JhM to in- 
sert con trol characters. Line feed and 
KWiiBJ cannot be inserted in t he text 
exce pt as ne wline characters. KttWRB 
and miJB.< are trapped by the operating 
system before they are interpreted by vi, 
so they too, cannot be inserted as text. 



Ctrl-w Moves the cursor back to the first char- 

acter of the last inserted word. 

Ctrl-t Inserts shiftwidth whitespace at the begin- 

ning of the current line with the auto- 
indent option set. 
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Ctrl-@ If typed as the first character of an in- 

sertion, it is replaced with the last text 
inserted, and the insertion terminates. 
Only 128 characters are saved from the last 
insertion. If more than 128 characters 
were inserted, then this command inserts no 
characters. A MUnBSM cannot be part of a 
file, even if quoted (preceded with a back- 
slash (\)). 



Command Summary 
Sample commands 



"•^ I I arrow keys move the cursor 

h j k 1 same as arrow keys 

itext W^SSM insert text 

cw ner^B^ gi change word to new 

eas li5kf4i add an s to a word 

X delete a character 

dw delete a word 

dd delete a line 

3dd delete 3 lines 

u undo previous change 

ZZ exit vi, saving changes 

:a!B yf!STtP quit, discarding changes 

/fextE351 search for text 

'U scroll up or down 

:cmdB2322i ^ny ex or ed command 



Counts before vi commands 

Numbers may be typed as a prefix to some commands. They 
are interpreted in one of these ways. 

line/column number z G | 

scroll amount "D 

repeat effect most of the rest 

Interrupting, canceling 

end insert or incomplete cmd 
itt^M (delete or rubout) interrupts 

*L reprint screen if DEL scrambles it 

reprint screen if "L is Right-arrow key 
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File manipulation ' 

; wBg/48iB write back changes 

tqlj^^^l^^^ quit, discard changes 
:e nomeB^JBI ^^it file name 

:e!|33SI reedit, discard changes 

:e+ n ame^Si^ SSi edit, starting at end 
;e + nBtfAiliW edit starting at line n 
♦.ft #M^SB edit alternate file 

QQBI synonjnn for :e # 

:w namejjj^^HjjL w^^® ^^^^ name 
;w ! nameBr/SilW overwrite file name 
rshJj^^L^ run shell, then return 
;! cjncW*liJRB run cmd, then return 
:nB332S__ edit next file in arglist 
:n argsESSS specify new arglist 

■ show current file and line 

:ta tagUs^ilH to tag file entry tag 

:ta, following word is tag 



In general, any ex or ed command (such as substitute or 
gl obal) m ay be ts^ped, preceded by a colon and followed by 
a UfMilW . 

Positioning within fUe 



"F forward screen 

backward screen 

scroll down half screen 
*U scroll up half screen 

G go to specified line (end of file is the 

default) 

/pat next line matching pat 

Ipat prev line matching pat 

n repeat last / or ? 

N reverse last / or ? 

Ipathn nth line after pat 

7pat?-n nth line before pat 

]] next section/function 

[[ previous section/function 

( beginning of sentence 

) end of sentence 

{ beginning of paragraph 

} end of paragraph 

% find matching () { or } 
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Adjusting the screen 



clear and redraw 
*R retype, eliminate @ lines 

zCR redraw, current at window top 

z-CR ... at bottom 

z.CR ... at center 

/pat/z-CR pat line at bottom 

zn.CR use n line window 

scroll window down 1 line 
"Y scroll window up 1 line 



Marking and returning 



move cursor to previous context 
" ... at first non- white in line 

mx mark current position with letter x 

*x move cursor to mark x 

'x ... at first non- white in line 



Line positioning 



H top line on screen 

L last line on screen 

M middle line on screen 

+ next line, at first non-white 

previous line, at first non-white 

CR return, same as + 

or j next line, same column 

or k previous line, same column 



Character positioning 





first non-white 


0 


beginning of line 


$ 


end of line 


h or 


forward 


1 or 


backwards 




same as 


space 


same as 


fx 


find X forward 


Fx 


f backward 


tx 


up to X forward 


Tx 


back up to X 


» 


repeat last f F t or T 


» 


inverse of ; 


1 


to specified column 




find matching ( {) or } 
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Words, sentences, paragraphs 



w 


word forward 


b 


back word 


0 


pTifi of wnrd 


) 


to next sentence 


} 


to next paragraph 


( 


back sentence 


{ 


back paragraph 


W 


blank delimited word 


B 


back W 


E 


to end of W 



Corrections during insert 

erase last character 
erase last word 
your erase, same as 
your kill, erase input this line 
quotes "H, your erase and kill 
ends insertion, back to command 
interrupt, terminates insert 
backtab over autoindent 
kill autoindent 

same as 0"D, but restores indent next line 
quote non-printing character 

Insert and replace 



a append after cursor 

i insert before cursor 

A append at end of line 

I insert before first non-blank 

o open line below 

O open above 

rx replace single char with x 

Rtextf |sH8i replace characters 



Operators 

Operators are followed by a cursor motion, and affect all 
text that would have been moved over. For example, since 
w moves over a word, dw deletes the word that would be 
moved over. Double the operator, e.g., dd to affect whole 
lines. 



H 



erase 

kill 

\ 




O^D 
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d 


delete 


c 


change 


y 


yank lines to buffer 


< 


left shift 


> 


right shift 




indent for LISP 


J 


filter through command 



FUter - ! 



S5mtax: Icursor movement cmd RETN 

Function: Filters the text object delimited by the 



cursor and cursor movement through the 
XENIX command, cmd. For example, the 
following command sorts all lines between 
the cursor and the bottom of the screen, 
substituting the designated lines with the 
sorted lines: 

!Lsort 

Arguments and shell metacharacters may be 
included as part of cmd; however, standard 
input and output are always associated with 
the text object being filtered. 



Miscellaneous Operations 



S 
J 

X 



C 
D 

s 



change rest of line 
delete rest of line 
substitute chars 
substitute lines 
join lines 
delete characters 
... before cursor 
yank lines 



(c$) 
(d$) 
(el) 

(CO) 



X 
Y 



(dl) 
(dh) 

(yy) 
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Yank and Put 

Put inserts the text most recently deleted or yanked. 
However, if a buffer is named, the text in that buffer is 
put instead. 



p put back text after cursor 

P put before cursor 

"xp put from buffer x 

"xy yank to buffer x 

"xd delete into buffer x 

Undo, Redo, Retrieve 

u undo last change 

U restore current line 

repeat last change 

"dp retrieve d'th last delete 



Other Commands 

The following command descriptions explain how to use mis- 
cellaneous ex commands. 

abbr Maps the first argument to the following 

string. For example, the following command 

:abbr rainbow yellow green blue red 

maps "rainbow" to "yellow green blue red". 
Abbreviations can be turned off with the 
unabbreviate command, as in: 

:una rainbow 

map, map! Maps any character or escape sequence to 
an existing command sequence. Characters 
mapped with map! work only in insert 
mode, while characters mapped with map 
work only in command mode. The unmap 
command removes the mapping. 
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preserve The current editor buffer is saved as 

though the system had just crashed. Use 
this command only in emergencies when a w 
command has resulted in an error and you 
don't know how to save your work. 

Prints the line number of the addressed 
line. The current line is unchanged. 

recover/iZe Recovers file from the system save area. 

The system saves a copy of the editing buf- 
fer only if you have made changes to the 
/iZe, the system crashes, or you execute a 
preserve command. Except when you use 
preserve, you will be notified by mail 
when a file is saved. 



source/iZc Reads and executes ex commands from the 

specified file. Source commands may be 
nested. 



taglabel The focus of editing switches to the loca- 

tion of label. If necessary, vi will 
switch to a different file in the current 
directory to find label. If you have modi- 
fied the current file before giving a tag 
command, you must first write it out. If 
you give another tag command with no argu- 
ment, the previous label is used. 



Similarly, if you type only a KWiiBa . vi 
searches for the word immediately after 
the cursor as a tag. This is equivalent 
to typing ":tag", the word, and then a 



The tags file is normally created by a 
program such as ctags, and consists of a 
number of lines with three fields sepa- 
rated by blanks or tabs. The first 
field gives the name of the tag, the 
second the name of the file where the 
tag resides, and the third gives an ad- 
dressing form which can be used by the 
editor to find the tag. This field is 
usually a contextual scan using 
/pattern/ to be immune to minor changes 
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in the file. Such scans are always per- 
formed as if the nomagic option were 
set. The tag names in the tags file 
must be sorted alphabetically. There 
are a number of options that can be set 
to affect the vi environment. These can 
be set with the ex set command, either 
while editing or immediately after vi is 
invoked in the vi start-up file, .exrc. 

version Prints the current version number of vi. 

Each time vi is invoked, it reads commands from the file 
named .exrc in your home directory and from variable 
EXINIT in your environment. This file and variable 
normally set your preferred options so that they need not 
be set manually each time you invoke vi. 



Options 

autoprint ap default: ap 

Causes the current line to be printed after each ex 
copy, move, or substitute command. This has the same 
effect as supplying a trailing "p" to each such com- 
mand. Autoprint is suppressed in globals, and only 
applies to the last of many commands on a line. 

beautify, bf default: nobeautify 

Causes all control characters except tab, new line 
and formfeed to be discarded from the input. A com- 
plaint is registered the first time a backspace char- 
acter is discarded. Beautify does not apply to com- 
mand input. 

directory, dir default: dir=/tmp 

Specifies the directory in which vi places the edit- 
ing buffer file. If this directory is not writeable, 
then the editor will exit abruptly when it fails to 
write to the buffer file. 
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edcompatible 



default: noedcompatible 



Causes the presence or absence of g and c suffixes on 
substitute commands to be remembered, and to be 
toggled on and off by repeating the suffixes. The 
suffix r causes the substitution to be like the "~" 
command, instead of like &. 

errorbells,eb default: noeb 

Precedes error messages by a bell. If possible, the 
editor always places the error message in inverse 
video instead of ringing the bell. 

hardtabs, ht default: ht=8 

Gives the boundaries on which terminal hardware tabs 
are set, or on which the system expands tabs. 

lisp default: nollsp 

Indents appropriately for LISP code, and the ( ) { } 
[[ and ]] commands are modified to have meaning for 
LISP. 

mesg default: nomesg 

Causes write permission to be turned off to the ter- 
minal while you are in visual mode, if nomesg is set. 
This prevents people writing to your screen with the 
write (C) command and scrambling your screen as you 
edit. 

open default: open 

Doesn't permit the commands open and visual if set to 
noopen. This is set to prevent confusion resulting 
from accidental entry to open or visual mode. 

optimize, opt default: optimize 

Expedites output of text to the screen by setting the 
terminal so that it does not perform automatic car- 
riage returns when printing more than one line of 
output, thus greatly speeding output on terminals 
without addressable cursors when text with leading 
whitespace is printed. 
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prompt default: prompt 

Prompts ex input with a colon (:). If no prompt is 
set, when ex command mode is entered with the Q 
command, no colon prompt is displayed on the status 
line. 

remap default: remap 

Tries mapped characters repeatedly, if on, until they 
are unchanged. For example, if o is mapped to O and 
O is mapped to I, o will map to I if remap is set, 
and to O if noremap is set. 

scroll default: scroll=l/2 window 



Determin es the number of logical lines scrolled when 
KWnBiB is received from a terminal input in Command 
Mode, and the number of lines printed by a Command 
Mode z command (double the value of scroll). 



shell, sh default: sh=/bm/sh 

Gives the pathname of the shell forked for the shell 
escape command "I" , and by the shell command. The 
default is taken from SHELL in the environment, if 
present. 

tabstop, ts default: ts=8 

Expands tabs in the input file to be on tabstop 
boundaries for purposes of display. 

taglength, tl default: tl=0 

Makes the first taglength characters in a tag name 
significant, but all others are ignored. A value of 
zero (the default) means that all characters are sig- 
nificant. 

tags default: tags=tags /usr/lib/tags 

Uses a path of files as tag files for the tag com- 
mand. A requested tag is searched for in the speci- 
fied files, sequentially. By default files named 
tags are searched for in the current directory and in 
/usr/lib. 
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window default: window=speed dependent 

Specifies the number of lines in a text window. The 
default is 8 at slow speeds (600 baud or less), 16 at 
medium speed (1200 baud), and the full screen (minus 
one line) at higher speeds. 

w300, wl200, w9600 

Sets the window option only if the speed is slow 
(300), medium (1200), or high (9600), respectively. 
These are not true options. 

wrapmargin, wm default: wm=0 

Defines the margin for automatic insertion of new- 
lines during text input. A value of zero specifies 
no wrap margin. 

writeany, wa default: nowa 

Inhibits the checks normally made before write com- 
mands, allowing a write to any file that the system 
protection mechanism will allow. 



Regular Expressions - New Read 

A regular expression specifies a set of strings of char- 
acters. A member of this set of strings is said to be 
matched by the regular expression. Vi remembers two pre- 
vious regular expressions: the previous regular expres- 
sion used in a substitute command and the previous regular 
expression used elsewhere, referred to as the previous 
scanning regular expression. The previous regular expres- 
sion can always be referred to by a null regular expres- 
sion: e.g., "//" or "??". 

The regular expressions allowed by vi are constructed in 
one of two ways depending on the setting of the magic op- 
tion. The ex and vi default setting of magic gives quick 
access to a powerful set of regular expression metacharac- 
ters. The disadvantage of magic is that the user must 
remember that these metacharacters are magic and precede 
them with a backslash (\) to use them as "ordinary" char- 
acters. With nomagic set, regular expressions are much 
simpler, there being only two metacharacters. The power 
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of the other metacharacters is still available by preced- 
ing the now ordinary character with a "\". Note that "\" 
is thus always a metacharacter. In this discussion the 
magic option is assumed. With nomagic, the only special 
characters are the caret (") at the beginning of a regular 
expression, the dollar sign ($) at the end of a regular 
expression, and the backslash (\). The tilde (~) and the 
ampersand (&) also lose their special meanings related to 
the replacement pattern of a substitute. 

The following basic constructs are used to construct magic 
mode regular expressions. 

char Matches an ordinary character with itself. Or- 

dinary characters are any characters except a 
caret (") at the beginning of a line, a dollar 
sign ($) at the end of line, a star (*) as any 
character other than the first, and any of the 
following characters: 

A [ - 

These characters must be escaped (i.e., preceded) 
by a backslash (\) if they are to be treated as 
ordinary characters. 

Forces, at the beginning of a pattern, the match 
to succeed only at the beginning of a line. $ 
Forces, at the end of a regular expression, the 
match to succeed only at the end of the line. 

Matches any single character except the newline 
character. 

< Forces the match to occur only at the beginning 

of a "word"; that is, either at the beginning of 
a line, or just before a letter, digit, or un- 
derline and after a character that is not one of 
these. 

> Matches the end of a "word"; similar to "\<", 

that is, either the end of the line or before a 
character that is not a letter, a digit, or the 
underline character. 
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[string] Matches any single character in the class de- 
fined by string. Most characters in string de- 
fine themselves. A pair of characters separated 
by a dash (-) in string defines the set of cha- 
lk racters between the specified lower and upper 
^ bounds. Thus, "[a-z]" as a regular expression 
matches any single lowercase letter. If the 
first character of string is a caret ("), the 
construct matches characters it otherwise would 
not. Thus, "["a-z]" matches anything but a 
lowercase letter or a newline. To place a 
caret, left bracket, or dash in string, escape 
them with a preceding backslash (\). 

The concatenation of two regular expressions first matches 
the leftmost regular expression and then the longest 
string that can be recognized as a regular expression. 
The first part of this new regular expression matches the 
first regular expression and the second part matches the 
second regular expression. Any of the 
single-character-matching regular expressions mentioned 
above may be followed by a "star" (*) to form a regular 
expression that matches zero or more adjacent occurrences 
, of the characters matched by the prefixing regular expres- 

sion. The tilde (~) may be used in a regular expression 
to match the text that defined the replacement part of the 
last s command. A regular expression may be enclosed be- 
tween the sequences "\(" and "\)" to remember the text 
matched by the enclosed regular expression. This text can 
later be interpolated into the replacement text using the 
notation: 

digit 

where digit enumerates the set of remembered regular ex- 
pressions. 

The basic metacharacters for the replacement pattern are 
the ampersand (&) and the tilde (~). These are given as 
"\&" and "\~" when nomagic is set. Each instance of the 
ampersand is replaced by the characters matched by the 
regular expression. In the replacement pattern, the tilde 
J stands for the text of the previous replacement pattern. 

Other possible metasequences in the replacement pattern 
are always introduced by a backslash (/). The sequence 
"\n" is replaced by the text matched by the nth regular 
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subexpression enclosed between "\(" and "\)". When 
nested, parenthesized subexpressions are present, n is 
determined by counting occurrences of "\(" starting from 
the left. The sequences "\u" and "\1" cause the immedi- 
ately following character in the replacement to be con- 
verted to uppercase or lowercase, respectively, if this 
character is a letter. The sequences "\U" and "L" turn 
such conversion on, either until "\E" or "\e" is encoun- 
tered, or until the end of the replacement pattern. 



Author 

Vi and ex were developed by The University of California, 
Berkeley California, Computer Science Division, Department 
of Electrical Engineering and Computer Science. 



Files 

/usr/lib/terminfo/?/* Compiled terminal description 

database 



See Also 

ed(C), edit(C), ex(C), and the User's Guide 



Notes 

Tampering with entries in /usr/lib/terminfo/?/* (for ex- 
ample, changing or removing an entry) can affect programs 
such as vi(C) that expect the entry to be present and cor- 
rect. In particular, removing the "dumb" terminal may 
cause unexpected problems. 

Software tabs using "T work only immediately after the 
autoindent. Left and right shifts on intelligent termi- 
nals do not make use of insert and delete character opera- 
tions in the terminal. 
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Name 

wait - Waits for completion of background processes. 

\ 

Sjmtax 

wait [n] 



Description 

This command waits until all background processes started 
with an ampersand (&) have finished and reports on abnor- 
mal terminations. 

n Waits until the process with PID n exits, or no 
children exist. 

Because the wait(S) system call must be executed in the 
parent process, the shell itself executes wait without 
creating a new process. 



See Also 

sh(C) 



Notes 

Not all of the processes of a pipeline with three or more 
stages are children of the shell, and cannot be waited 
for. 

If n is not an active process id, all of your shell's cur- 
rently active background processes are waited for and the 
return code will be zero. 
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Name 

wall - Writes to all users. 

Syntax 

/etc/wall 

Description 

Wan read s its standard input until an end-of-file 
CWiBBiB ). It then sends the message you enter, preceded 
by the phrase "Broadcast Message," to all logged in users. 

Log in as the super-user before executing wall to override 
any protections the users may have invoked. You can use 
wall to warn all users before shutting down the system. 

Files 

/dev/tty 

Related Commands 

mesg(C), write(C) 

Diagnostics 

"Cannot send to ..." when the open on a user's tty file 
fails. 
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Name 

wc - Counts lines, words, and characters. 



Syntax 

wc [ -clw ] [ file ... ] 



Description 

Wc counts lines, words and characters in the named files, 
or in the standard input if no names appear. It also 
keeps a total count for all named files. A word is a max- 
imal string of characters delimited by spaces, tabs, or 
newlines. The options are: 

-c Counts characters. 

-1 Counts lines. 

-w Counts words. 

The default is -Iwc. 

When files are specified on the command line, their names 
will be printed along with the counts. 
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Name 

what - Identifies SCCS files. 



Syntax 

what [-s] file.,. 



Description 

What searches the given files for all occurrences of the 
pattern that get(C) substitutes for %Z% (this is @(#) at 
this printing) and prints out what follows until the first 
>, newline, \, or null character. For example, if the 
C program in file f.c contains: 

char ident[] = "@(#) identification information"; 

and f.c is compiled to yield f.c and a. out, then the com- 
mand: 

what f.c f.o a. out 

will print: 
f.c: 

identification information 

f.o: 

identification information 

a. out: 

identification information 

What is intended to be used in conjunction with the com- 
mand get(C), which automatically inserts identifying in- 
formation, but it can also be used where the information 
is inserted manually. Only one option exists: 

-s Quit after finding the first occurrence of pattern in 
each file. 
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See Also 

get(C), help(C) 

Diagnostics 

Exit status is 0 if any matches are found, otherwise 1. 

Notes 

It is possible that an unintended occurrence of the pat- 
tern @(#) could be found just by chance, but this causes 
no harm in nearly all cases. 
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Name 

whereis - Locates source, binary, or manual for program. 



Sjnitax 

whereis [ -bms ] [ -u ] [ -BMS dir ... -f ] name ... 



Description 

Whereis locates source, binary and manual sections for 
specified files. The supplied names are first stripped of 
leading pathname components and any (single) trailing ex- 
tension of the form ".ext", e.g. ".c". Prefixes of "s." 
resulting from use of source code control are also dealt 
with. Whereis then attempts to locate the desired program 
in a list of standard places. 

-b Searches for binary sections only. 

-m Searches for manual sections only. 

-s Searches for sources only. 

-u Searches for unusual entries. A file is said to be 
unusual if it does not have one entry of each re- 
quested type. 

For example, 

whereis -m -u * 

asks for those files in the current directory that have no 
documentation. 

The -B, -M, and -S flags may be used to limit or otherwise 
change the places whereis searches. Each specifies a di- 
rectory list in which to search for the corresponding type 
of file. The -f flag is used to terminate the last such 
directory list and signal the start of file names. 
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Example 

The following finds all the files in /usr/bin that are not 
documented in /usr/man/manl with source in /usr/src/cmd: 

cd /usr/bin 

whereis -u -M /usr/man/manl -S /usr/src/cmd -f * 



Files 

/usr/src/* 
/usr/man/* 
/lib, /etc, /bin 
/usr/bin 
/usr/lib 



Notes 

Since the program uses chdir(S) to run faster, pathnames 
given with the -B, -M, and -S must be full; i.e., they 
must begin with a "/". 

Whereis does not use the environment variable PATH to lo- 
cate files, but has a built-in list of directories to 
search. See path(M) for more information. 
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Name 

who - Displays who is on the system. 



Syntax 

who [-uTlHqpdbrtaAs] [/ile] 
who am i 
who am I 

who is on [machine^ [@] 



Description 

Who can list the user's name, terminal line, login time, 
elapsed time since activity occurred on the line, and the 
process-ID of the command interpreter (shell) for each 
current system user. It examines the /etc/wtmp, which 
contains a history of all the logins since the file was 
last created. 

Who with the am i or am I option identifies the invoking 
user. 

The general format for output is: 

name [stated line time [idle] [pid] [comment^ [exit] 

The name, h'nc, and time information is produced by all 
options except -q; the state information is produced only 
by -T; the idle and pid information is produced only by -u 
and -1; and the comment and exit information is produced 
only by -a. The information produced for -p, -d, and -r 
is explained on the following pages. 

With options, who can list logins, logouts, reboots, and 
changes to the system clock, as well as other processes 
spawned by the hiit process. These options are: 

-u Lists only those users who are currently logged in. 
The name is the user's login name. The line is the 
name of the line as found in the directory /dev. The 
time is the time that the user logged in. The idle 
column contains the number of hours and minutes since 
activity last occurred on that particular line. A 
dot (.) indicates that the terminal has seen activity 
in the last minute and is therefore "current." 
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If more than twenty-four hours have elapsed or the 
line has not been used since boot time, the entry is 
marked old. This field is useful when trying to de- 
termine whether a person is working at the terminal 
or not. The pid is the process-ID of the user's 
shell. The comment is the comment field associated 
with this line as found in /etc/inittab (see 
inittab(M)). This can contain information about 
where the terminal is located, the telphone number of 
the dataset, type of terminal if hardwired, etc. 

-T Same as the -s option, except that the state of the 
terminal line is printed. The state describes 
whether someone else can write to that terminal. A + 
appears if the terminal is writable by anyone; a - 
appears if it is not. Root can write to all lines 
having a + or a - in the state field. If a bad line 
is encountered, a ? is printed. 

-1 Lists only those lines on which the system is waiting 
for someone to login. The name field is LOGIN in 
such cases. Other fields are the same as for user 
entries except that the state field does not exist. 

-H Prints column headings above the regular output. 

-q Displays only the names and the number users cur- 
rently logged on (a quick who). When this option is 
used, all other options are ignored. 

-p Lists any other process which is currently active and 
has been previously spawned by init. The name field 
is the name of the program executed by init as found 
in /etc/inittab. The state^ line, and idle fields 
have no meaning. The comment field shows the id 
field of the line from /etc/inittab that spawned this 
process. See inittab(M). 

-d Displays all processes that have expired and not been 
respawned by init. The exit field appears for dead 
processes and contains the termination and exit 
values (as returned by wait(C)), of the dead process. 
This can be useful in determining why a process ter- 
minated. 

-b Indicates the time and date of the last reboot. 
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-r Indicates the current run-level of the init process. 
In addition, it displays the number of times the sys- 
tem has been in the current run-level and the pre- 
vious run-level. 

-t Indicates the last change to the system clock (via 
the date(C) command) by root. See su(C). 

-a Processes /etc/utmp or the named file with all op- 
tions turned on. 

-A Lists accounting information. 

-s Lists only the name, line, and time fields (the 
default). 

is on machine 

Lists names of users on machine on a Worknet network, 
is on @ 

Lists all users on all machines on a Worknet network. 

Note to the super-user: after a shutdown to the single- 
user state, who returns a prompt; the reason is that since 
/etc/utmp is updated at login time and there is no login 
in single-user state, who cannot report accurately on this 
state. Who am i, however, returns the correct information. 



Files 

/etc/utmp 
/etc/wtmp 
/etc/inittab 



See Also 



date(C), login(C), mesg(C), su(C), init(M), wait(C), 
inittab(M), utmp(M) 
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Name 

whoami - Prints current effective user id. 

Syntax 

whoami 

Description 

Whoami prints who you are. It prints the effective user 
id, even if you have run su(C). Who am i prints the real 
login, as it looks in /etc/utmp. 

Files 

/etc/passwd Name data base 

See Also 

who(C), su(C) 
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Name 

whom - Displays in a columnar format all logged in users. 

Syntax 

who [-1] 

Description 

The whom command displays the user ID, log-in time, and 
tty for all users currently logged in to the system. 

This command is much like the who command, except that 
whom displays this information in a more convenient 
columnar farmat. 

The -1 option reports how long each user has been logged 
in instead of the log-in time. 

See Also 

who(C) 
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Name 

write - Writes to another user. 



Syntax 

write user [ line ] 



Description 

Write copies lines from your terminal to that of another 
user. When first called, it sends the message: 

Message from yourname (ttynn) [ date ]... 

to the person you want to talk to. When it has success- 
fully completed the connection, it also sends two bells to 
your own terminal to indicate that what you are typing is 
being sent. 

The recipient of the message should write back at this 
point. Communication continues until an end of file is 
read from the terminal, an interrupt is sent, or the re- 
cipient has executed "mesg n". At that point, write 
writes EOT on the other terminal and exits. 

If you want to write to a user who is logged in more than 
once, the line argument may be used to indicate which line 
or terminal to send to (e.g., ttyOO); otherwise, the first 
writable instance of the user found in /etc/utmp is as- 
sumed and the following message posted: 

user is logged on more than one place. 
You are connected to "terminal". 
Other locations are: 
terminal... 

Permission to write may be denied or granted by use of the 
mesg(C) command. Writing to others is normally allowed by 
default. Certain commands, such as pr(C), disallow mes- 
sages in order to prevent interference with their output. 
However, if the user has super-user permissions, messages 
can be forced onto a writeinhibited terminal. 
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If the character I is found at the beginning of a line, 
write calls the shell to execute the rest of the line as a 
command. 



See Also 

mail(C), mesg(C), pr(C), sh(C), who(C) 

Diagnostics 

user is not logged on 

The person you are trying to write to is not logged 
on. 

Permission denied 

The person you are trying to write to denies that 
permission (with mesg). 

Warning: cannot respond, use "Imesg -y" 

Your terminal is set to mesg n and the recipient 
cannot respond to you. 

Can no longer write to user 

The recipient has denied permission (mesg n) after 
you had started writing. 



Files 



/etc/utmp 
/bin/sh 



To find user 
To execute ! 
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Name 

xargs - Constructs and executes commands. 



Syntax 

xargs [ flags ] [ command [ initial-arguments ] ] 



Description 

Xargs combines the fixed initial-arguments witii arguments 
read from the standard input to execute the specified com- 
mand one or more times. The number of arguments read for 
each command invocation and the manner in which they are 
combined are determined by the flags specified. 

Command, which may be a shell file, is searched for using 
the shell $PATH variable. If command is omitted, 
/bin/echo is used. 

Arguments read in from standard input are defined as con- 
] tiguous strings of characters delimited by one or more 

spaces tabs, or newlines; empty lines are always dis- 
carded. Spaces and tabs may be embedded as part of an 
argument if escaped or quoted. Characters enclosed in 
quotation marks (single or double) are taken literally, 
and the delimiting quotation marks are removed. Outside 
of quoted strings, a backslash (\) will escape the next 
character. 

Construct each argument list starting with the 
initial-arguments, followed by some number of arguments 
read from standard input (exception: see -1 flag). The 
-i, -1, and -n flags determine how arguments are selected 
for each command invocation. When none of these flags 
are coded, the initial-arguments are followed by arguments 
read continuously from standard input until an internal 
buffer is full, and then command is executed with the ac- 
cumulated args. This process is repeated until there are 
no more arguments. When there are flag conflicts (e.g., 
J -1 vs. -n), the last flag has precedence. Flag values 

are: 
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-Inumber Command is executed for each number lines 

of nonempty arguments from the standard 
input. This is instead of the default 
single line of input for each command. The 
last invocation of command will be with 
fewer lines of arguments if fewer than num- 
ber remain. A line is considered to end 
with the first newline unless the last 
character of the line is a space or a tab; 
a trailing space/tab signals continuation 
through the next nonempty line. If number 
is omitted, 1 is assumed. The -x option is 
forced. 



-ireplstr Insert mode: command is executed for each 

line from the standard input, taking the 
entire line as a single arg, and inserting* 
it in initial-arguments for each occurrence 
of replstr. A maximum of five arguments ir 
initial-arguments may each contain one or 
more instances of replstr. Spaces and tabs 
at the beginning of each line are thrown 
away. Constructed arguments may not grow 
larger than 255 characters, and the -x 
option is also forced. {} is assumed for 
replstr if not specified. 

-nnumber Executes command using as many standard 

input arguments as possible, up to number 
arguments maximum. Fewer arguments will 
be used if their total size is greater than 
size characters, and for the last invoca- 
tion if there are fewer than number argu- 
ments remaining. If the -x option is also 
coded, each number arguments must fit in 
the size limitation, or else xargs termi- 
nates execution. 



-ssize The maximum total size of each argument 

list is set to size characters; size must 
be a positive integer less than or equal to 
470. If -s is not coded, 470 is taken as 
the default. Note that the character couni 
for size includes one extra character for 
each argument and the count of characters 
in the command name. 
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-t Trace mode: The command and each con- 

structed argument list are echoed to file 
descriptor 2 just prior to their execution. 

-p Prompt mode: The user is asked whether to 

execute command each invocation. Trace 
mode (-t) is turned on to print the command 
to be executed, followed by a ?... prompt. 
A reply of "y" (optionally followed by 
anything) will execute the command; any- 
thing else, including just a |2323i> skips 
that particular invocation of command. 

-X Causes xargs to terminate if any argument 

list would be greater than size characters; 
-x is forced by the -i and -1 options. 
When none of the -i, -i, or -n options are 
coded, the total length of all arguments 
must be within the size limit. 



-eeofstr Eofstr is taken as the logical end-of-file 

string. Underscore (_) is assumed for the 
logical EOF string if -e is not coded, -e 
with no eofstr coded turns off the logical 
EOF string capability (underscore is taken 
literally). Xargs reads standard input 
until either end-of-file or the logical EOF 
string is encountered. 

Xargs terminates if it either receives a return code of -1 
from command, or if it cannot execute command. When 
command is a shell program, it should explicitly exit (see 
sh(C)) with an appropriate value to avoid returning acci- 
dentally with -1. 



Examples 

The following example will move all files from directory 
$1 to directory $2, and echo each move command just be- 
fore doing it: 

Is $1 I xargs -i -t mv $i/{} $2/{} 
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The following will combine the output of the parenthesized 
commands onto one line, which is then echoed to the end of 
the file named log: 

(logname; date; echo $0 $*) | xargs »log 

The user is asked which files in the current directory are 
to be printed and prints them one at a time: 

Is I xargs -p -1 Ipr 

Or many at a time: 

Is I xargs -p -1 I xargs ipr 

The following example will execute diff(C) with successive 
pairs of arguments originally typed as shell arguments: 

echo $* I xargs -n2 diff 

See Also 
sh(C) 
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Name 

xtty - Sets the options for a terminal. 



Syntax 



xtty [-a] [-g] [options] [ttynn] [device ...] 
modem ttynn 
unmodem ttynn 



Description 

Xtty sets the options for a terminal. It is an extension 
of the stty(C) command. To list settings, type xtty with 
no options. 

There are three ways ports are used that affect modems: 
as a local port, as a dial-in port, and as a dial-out 
port. 

On normal asynchronous communication ports, there is one 
output line (data-set-ready) and one input line (data- 
terminal-ready). Data-set-ready controls output for local 
ports and carrier present for modems. Data-terminal-ready 
controls input for local ports and carrier present for 
modems. 



Options 
-a 

-s 



disable 



Reports all option settings. 

Reports current settings that can be used 
as an argument to another xtty command. 

Turns off (disables) the specified ter- 
minal(s). For example, to turn off ttyOl 
and tty02, type xtty disable ttyOl tty02. 
You can disable and enable (see below) ter- 
minals in a single command. For example, 
type xtty disable ttyOl -e tty02 to dis- 
able ttyOl and enable tty02. 
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enable 



[-]iflow 
[-loflow 
modem 

unmodem 
ttynn 

/dev/xxx 



Turns on (enables) the specified ter- 
minal(s). For example, to turn on ttyOl 
and tty02, type xtty enable ttyOl tty02. 
You can enable and disable (see above) ter- 
minals in a single command. For example, 
type xtty enable ttyOl -d tty02 to enable 
ttyOl and disable tty02. 

Turns on hardware input flow control. The 
minus sign (-) turns it off. 

Turns on hardware output flow control. The 
minus sign (-) turns it off. 

Sets up the specified tty port for use with 
a modem. For example, to set up ttyOl, 
type xtty modem ttyOl. 

Unsets a tty port for modem use ~ the re- 
verse of modem (see above). 

Specifies the port, where nn is a 2-digit 
port number (e.g., 05). If no port is spe- 
cified, standard input is used. 

Specifies a device, where xxx is the device 
(e.g., console). If no port is specified, 
standard input is used. 



To use a port as a local port, enable it and set the modem 
flag to either user or off (see modem). Use your own dis- 
cretion to set hupcl (if modem is user), if low, and of low. 
Normally, hupcl is true, if low is false, and of low is 
true. 

To use a port as a dial-in port, enable it and set the 
modem flag to on and hupcl to true. I flow, of low, and 
clocal should be false. 



To use a port as a dial-out port, disable it. Set the 
modem flag to user and hupcl to true. Iflow and oflow 
should both be false. Set clocal at your own discretion. 
If you want to output to the modem when carrier is not 
present (e.g., to issue modem commands), open the port 
with the 0_NDELAY flag set, or with clocal true. 
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All unknown flags are passed on to the stty(C) command. 
If a port was specified, it will be redirected to standard 
input. 

) 

Files 

/dev/ttynn 

/dev/console 

/etc/ttys 



See Also 

setmodem(C), stty(C) 
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Name 

yes - Prints a string repeatedly. 



Syntax 

yes [ string ] 



Description 

Yes repeatedly outputs "y"» or if a single string argument 
is given, it is output repeatedly. The command will con- 
tinue indefinitely unless aborted. Yes is useful in pipes 
to commands that prompt for input and require a "y" re- 
sponse for a yes. In this case, yes terminates when the 
command that it pipes to terminates, so that no infinite 
loop occurs. 
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Change Information 



This is a summary of the changes that have been made to 
the previous version of this manual. The chapters, page 
numbers, and/or paragraphs mentioned in this summary re- 
ference the previous manual. 

Title: Altos System V Series 386 Reference (C) 

Revised Part Number: 690-22869-002 

Previous Part Number: 690-22869-001 

Date: June 1989 

Changes: 

Updated the Permuted Index and Table of Contents. 
Added shl(C) and whom(C). 
Renamed ftp(C) to aftp(C). 
Changed the following pages: 

Page Command Description 

1 acct(C) Removed reference to the /etc/rc5 



file, which no longer exists. 
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at(C) 



Changed queue file name to 
queuedefs. 
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cpio(C) 



Removed erroneous quaotation 
marks at end of example. 
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cron(C) 



Changed file name S75cron to 
the more general form S??cron. 
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Page Command Description 



2 cron(C) Deleted information on cron 

error logging being turned on or 
off. 

2 ct{C) Added information on how ct 

interacts with existing getty 
or uugetty processes. 

4 cu(C) Data transfers with cu are ini- 

tiated with the ~> characters, 
not the ~ character as previous- 
ly documented. 

2 devinfo(C) Explained how SIO boards are 

reported as Mulidrops on 386 
Series 1000 systems. 

1 devnm(C) Deleted references to brc(M). 

4 dos(C) Using "*.*" with doscopy copies 

all files from the root directory, 
not from the entire disk. 

1,15 ed(C) The -x encryption option is no 

longer offered. 

1 edit(C) The -x encryption option is no 

longer offered. 

1 enroll{C) Typing ? displays valid xget 

conmiands. 

1 logname(C) The logname command does not 

get its value from $LOGNAME. 

3 lp(C) Described how to use Ip to 

print a file that is not readable 
by others. 

1 setmode(C) Emphasized that setmode sets 

port modes for serial devices, 
not just serial printers. 
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Page Command Description 



) 1 sysconf(C) Described how SIO boards are 

reported on 386 Series 1000 
systems. 

1,4 tar(C) Added o option and description 

for specifying the user and group 
IDs of extracted files. 

2 uux(C) Added description on how to use 

parentheses to enclose remote 
output files designations. 

1 vi(C) The -x encryption option is no 

longer offered. 
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(BLANK) 
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READER'S COMMENTS 



Manual Title: Altos System V Series 386 Reference (C) 
Part Number: 690-22869-002 

Altos Computer Systems' Publications Department wants to 
provide documents that meet the needs of all our customers. 
Your comments help us produce better manuals. 

Please Rate 

This Manual: Excellent Good Average Fair Poor 

Completeness of information I I | 11 I I I I 

Organization of manual 

Adequate illustrations _____ 
Overall manual 



Do you find any of the chapters confusing or difficult to use? 
If so, which ones and why? 



What could we do to improve the manual for you? 



If you find errors or other problems when using this manual, 
please write them below. Do include page numbers or section 
titles. 



Name: 



Company: 

Phone: ( ) 



Title: 

Type of system: 
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